OnSong^® Binder

Das OnSong^® Binder-Dateiformat ist die Art, wie OnSong ein Lied, einen Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archive enthält es alles, was erforderlich ist, um den Inhalt an anderer Stelle zu rekonstruieren — den Liedtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelnes undurchsichtiges Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Das macht es lesbar, inspizierbar 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 entweder .onsongbinder oder .binder und einen MIME-Typ von application/onsong-binder.

Was ist drin?

Ein Binder ist ein ZIP-Archiv. Entpacken Sie einen und Sie werden einen Ordner finden, der nach der Kennung des Elements benannt ist und Folgendes enthält:

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

Diese Struktur wiederholt sich bis ganz 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 einen einzelnen Song enthält.

In einem Manifest 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 daneben zeigt, erkennen kann.

Was es trägt

• Lieder — das Akkord-Diagramm und alles, das damit verbunden ist.
• Sätze — die Lieder in ihrer Reihenfolge mit der 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 Anhänge einzubinden, die tatsächlich verwendet werden, anstatt jede Version, die jemals hinzugefügt wurde.

Binder oder Archiv?

Beide transportieren den Inhalt einer Bibliothek treu hin und her, daher hängt die Wahl davon ab, 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 Format. Verwenden Sie es, um es mit neueren Versionen von OnSong freizugeben — und wenn Sie eine Datei haben möchten, die Sie öffnen und ansehen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie eine aus Dateien, Mail, AirDrop oder einem Cloud-Service und wählen Sie OnSong. Das Importieren eines Binders, der einen Satz enthält, erstellt den Satz und jedes darin enthaltene Lied neu; das Importieren eines Binders mit einem einzelnen Lied fügt dieses Lied hinzu.

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

Binder sind auch das, was OnSong Connect zwischen Geräten sendet, wenn ein Gerät ein anderes nach einem Lied oder einem Satz fragt. Das gleiche Format, das sich in Ihrer Dateien-App befindet, ist also das, das über das Netzwerk reist.

Da ein Binder eine ZIP-Datei aus einfachen JSON und gewöhnlichen 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 es nicht OnSong ist.