OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Methode, mit der OnSong ein Lied, einen Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archive enthält es alles, was zum Wiederaufbau des Inhalts an anderer Stelle erforderlich ist — den Songtext, Anhänge, Stile, Einstellungen, Transponierung und Anmerkungen — aber während ein Archiv ein einzelner undurchsichtiger Blob ist, ist ein Binder ein Ordner mit normalen Dateien. Dies macht ihn lesbar, überprüfbar und in der Lage, die Medien, auf die ein Lied angewiesen ist, zusammen mit dem Lied selbst auf plattformunabhängige Weise zu transportieren.

Das OnSong^® Binder-Dateiformat hat eine Dateierweiterung von .onsongbinder oder .binder und einen MIME-Typ von application/onsong-binder.

Was drin ist

Ein Binder ist ein ZIP-Archiv. Wenn Sie einen entpacken, finden Sie einen Ordner mit dem Namen der Kennung des Elements, der Folgendes enthält:

• manifest.json — das Element selbst, serialisiert. Jede Eigenschaft, die OnSong kennt, in der gleichen Form, die die OnSong Web API verwendet.
• Seine Datei, falls vorhanden. Ein Anhang behält seinen ursprünglichen Dateinamen bei, daher ist ein PDF oder eine MP3 in einem Binder genau dieses PDF oder diese MP3.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind — songs, attachments — jeder mit mehr Ordnern der genau gleichen Struktur.

Diese Struktur wiederholt sich bis ganz nach unten: Ein Satz enthält Lieder, ein Lied enthält Anhänge, und jedes ist ein Ordner mit seinem eigenen Manifest neben seinen eigenen Dateien. Ein Binder, der ein Buch mit zweihundert Liedern enthält, hat das gleiche Format wie einer, der ein einzelnes Lied enthält.

Innerhalb eines Manifests werden Verweise auf untergeordnete Elemente mit einem $binder.-Präfix gekennzeichnet, damit ein Leser den Unterschied zwischen einem Wert, der zum Element gehört, und einem, der auf einen Ordner neben ihm verweist, erkennen kann.

Was er transportiert

• Lieder — das Akkorddiagramm und alles, das daran angebracht ist.
• Sätze — die Lieder in ihrer Reihenfolge mit der eigenen Anordnung des Satzes.
• Bücher — eine ganze Sammlung.
• Anhänge — PDFs, Bilder, Audio und alle anderen Dateien, die mit einem Lied verknüpft sind. Sie können wählen, nur die tatsächlich verwendeten Anhänge einzubeziehen, anstatt jede Version, die jemals hinzugefügt wurde.

Binder oder Archiv?

Beide transportieren den Inhalt einer Bibliothek treu hin und zurück, daher geht es bei der Wahl um das, was Sie von der Datei benötigen:

• OnSong^® Archive ist das ältere Format und sollte verwendet werden, um die Kompatibilität mit früheren Versionen von OnSong zu gewährleisten.
• OnSong^® Binder ist das aktuelle. Verwenden Sie es zum Teilen mit neueren Versionen von OnSong — und wenn Sie eine Datei benötigen, die Sie öffnen und inspizieren können.

Importieren und Exportieren

Binder importieren wie jede andere Datei: Öffnen Sie einen aus Files, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der einen Satz enthält, erstellt den Satz und jedes Lied darin neu. Das Importieren eines Binders, der ein einzelnes Lied enthält, fügt dieses Lied hinzu.

Um einen zu erstellen, verwenden Sie Teilen und wählen Sie OnSong Binder als Format.

Binder sind auch das, was OnSong Connect zwischen Geräten sendet, wenn ein Gerät ein anderes um ein Lied oder einen Satz bittet. Das gleiche Format, das in Ihrer Files-App vorhanden ist, wird daher auch über das Netzwerk übertragen.

Da ein Binder ein ZIP aus einfachen JSON- und normalen Mediendateien ist, ist es das richtige Format, wenn Sie sehen müssen, was OnSong tatsächlich gespeichert hat — oder wenn etwas Ihren Inhalt lesen muss und nicht OnSong ist.