OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, eine Setlist oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archiv enthält es alles, was zum Wiederherstellen des Inhalts an anderer Stelle erforderlich ist — den Liedtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelner undurchsichtiger Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Dies macht ihn lesbar, überprüfbar und in der Lage, die Medien, auf die ein Lied angewiesen ist, neben dem Lied selbst auf plattformunabhängige Weise zu tragen.

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

Was ist darin enthalten

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 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, sodass ein PDF oder eine MP3 in einem Binder einfach dieses PDF oder diese MP3 ist.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind — songs, attachments — jeder mit weiteren Ordnern mit genau der gleichen Struktur.

Diese Struktur wiederholt sich bis zum Ende: Eine Setlist enthält Lieder, ein Lied enthält Anhänge, und jedes hat einen Ordner mit seinem eigenen Manifest neben seinen eigenen Dateien. Ein Binder mit einem Buch mit zweihundert Liedern hat das gleiche Format wie einer mit nur einem Chart.

In einem Manifest werden Verweise auf untergeordnete Elemente mit einem $binder.-Präfix gekennzeichnet, damit ein Reader den Unterschied zwischen einem Wert, der zum Element gehört, und einem, der auf einen Ordner daneben verweist, erkennen kann.

Was es enthält

• Lieder — das Akkordschema und alles, was damit verbunden ist.
• Setlisten — die Lieder in ihrer Reihenfolge, mit der eigenen Anordnung der Setlist.
• 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 einzuschließen, anstatt jede jemals hinzugefügte Version.

Binder oder Archiv?

Beide durchlaufen den Inhalt einer Bibliothek treu, daher geht es bei der Auswahl darum, was Sie von der Datei benötigen:

• OnSong^® Archiv ist das ältere Format und sollte für die Kompatibilität mit früheren Versionen von OnSong verwendet werden.
• OnSong^® Binder ist der aktuelle. Verwenden Sie ihn zum Teilen mit neueren Versionen von OnSong — und wenn Sie eine Datei möchten, die Sie öffnen und einsehen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie einen aus Dateien, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der eine Setlist enthält, erstellt die Setlist 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 nach einem Lied oder einer Setlist fragt, sodass das gleiche Format, das sich in Ihrer Dateien-App befindet, über das Netzwerk übertragen wird.

Da ein Binder eine ZIP-Datei mit einfachem 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 nicht OnSong ist.