Api für Song Arrangements: Felder "sourceName" und "sourceReference"

BiKi

Hallo,

In den Api call /songs?include=arrangements und /songs/{songId}/arrangements haben die Item für die Arrangements die beiden Felder "sourceName" und "sourceReference".
Diese beiden Felder sind in der API Doku nicht dokumentiert und sind bei uns immer null.

Was haben sie zu bedeuten?

sbellon

Hallo @BiKi

es handelt sich dabei um die Felder "Quelle" und "Liednummer" aus der Oberfläche, z.B.:

Wenn die gesetzt sind, sollten sie auch in der API entsprechend gesendet werden, bei unserer ChurchTools-Instanz funktioniert das zumindest.

Viele Grüße
Stefan

BiKi

Interessant, die Felder gibt es bei uns nicht…

sbellon

Hm, vielleicht werden die nur dynamisch eingeblendet, wenn ihr auch in den Song-Stammdaten "Quellen" definiert habt?

BiKi

@sbellon wir hatten tatsächlich bisher keine Quelle in den Stammdaten, weil ich das Feature bisher nicht kannte. (Die Info in welchem Liederbuch die Lieder sind, haben wir über Tags abgebildet. Daher würden wir die Quelleninformationen auch gerne nutzen).
Habe nun Quelle in den Stammdaten angelegt, aber die Felder tauchen nun trotzdem nicht auf.

Vielleicht kann uns jemand von ChurchTools aufklären?

jziegeler

@BiKi dann musst du dich damit mal bitte beim Support melden, da scheint was kaputt zu sein

BiKi

Dieser Beitrag wurde gelöscht!

BiKi

@jziegeler ich nehm alles zurück, mit einer neuen Session taucht das doch auf… (wohl nur ein Caching Problem), vielen Dank auch an @sbellon. Habe ein neues nützliches Feature entdeckt…

sbellon

@BiKi sagte in Api für Song Arrangements: Felder "sourceName" und "sourceReference":

@sbellon wir hatten tatsächlich bisher keine Quelle in den Stammdaten, weil ich das Feature bisher nicht kannte. (Die Info in welchem Liederbuch die Lieder sind, haben wir über Tags abgebildet. Daher würden wir die Quelleninformationen auch gerne nutzen).

Unser ChurchSong validiert auch, dass Tags und Quellen konsistent gesetzt sind, sowie dass eine Konsistenz zwischen dem Tag EN/DE und #LangCount=2 in der .sng-Datei besteht.

Simon2

@BiKi: Schön, dass es jetzt funktioniert.

Generell: Nach meiner Erfahrung brauchen viele Änderungen oft ein "Nachladen des Moduls" (also z.B. hier nochmal auf "Events" klickt), bevor sie "sichtbar werden".

Song-(Arrangement-)Quellen wurden lt. Changelog mit 3.113 am 16.09.24 eingeführt.
Ist aber auch gemein, dass man das quasi nur über das Changelog oder die Stammdaten rausbekommt (weil die Felder sonst ausgeblendet sind).

ABER:

...Die Info in welchem Liederbuch die Lieder sind, haben wir über Tags abgebildet.

Im Gegensatz zu Tags kann man Quellen

nur dem Arrangement zuordnen (und nicht dem Song selbst) und
dort dann aber auch nur einer Quelle.

Es ist also nicht (so einfach) möglich, mehrere Quellen eines Songs zu hinterlegen, wie mit Tags.
Dafür hat man aber gleich auch die Liednummer.

Kein großes Thema, sollte man aber wissen.