OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, einen Song-Satz oder ein ganzes Buch zwischen Bibliotheken bewegt. 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 es lesbar, inspizierbar und ermöglicht es, die Medien, von denen ein Lied abhängt, 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 eines entpacken, finden Sie einen Ordner mit dem Namen des Elementbezeichners, der Folgendes enthält:

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

Diese Struktur wiederholt sich bis ganz nach unten: Ein Song-Satz enthält Lieder, ein Lied enthält Anhänge, und jeder 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 ein Binder, der ein einzelnes Chart hält.

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 Wert, der auf einen Ordner daneben zeigt, erkennen kann.

Was es enthält

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

Binder oder Archiv?

Beide transportieren den Inhalt einer Bibliothek zuverlässig hin und her, daher hängt die Wahl davon ab, 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 die aktuelle Version. Verwenden Sie diese zum Teilen mit neueren Versionen von OnSong — und wenn Sie eine Datei benötigen, die Sie öffnen und ansehen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie eine aus der App Dateien, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders mit einem Song-Satz erstellt den Song-Satz und alle Lieder darin 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.

Binder sind auch das, was OnSong Connect zwischen Geräten sendet, wenn ein Gerät von einem anderen ein Lied oder einen Song-Satz anfordert. Daher ist das gleiche Format, das sich in Ihrer Dateien-App befindet, das Format, das über das Netzwerk verreist.

Da ein Binder ein ZIP von 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.