OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Methode, 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 neu zu erstellen — den Liedtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelner, undurchsichtiger Block 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 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. Wenn Sie ein entpacken, finden Sie einen Ordner, der nach dem Bezeichner des Elements benannt ist und Folgendes enthält:

• manifest.json — das Element selbst, serialisiert. Jede Eigenschaft, die OnSong darüber kennt, in derselben 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 innerhalb eines Binders 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 derselben Struktur.

Diese Struktur wiederholt sich auf ganzer Linie: 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 mit einem Buch mit zweihundert Liedern hat das gleiche Format wie ein Binder mit einem einzelnen Chart.

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

Was es transportiert

• Lieder — das Akkorddiagramm und alles, was daran angehängt 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 Anhänge einzubeziehen, die tatsächlich verwendet werden, anstatt jede jemals hinzugefügte Version.

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^® Archive ist das ältere Format und sollte für die Kompatibilität mit früheren Versionen von OnSong verwendet werden.
• OnSong^® Binder ist das aktuelle. Verwenden Sie es zum Austausch 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 einen von Dateien, Mail, AirDrop oder einem Cloud-Dienst aus und wählen Sie OnSong. Wenn Sie einen Binder importieren, der einen Satz enthält, wird der Satz und jedes Lied darin neu erstellt. Wenn Sie einen importieren, der ein einzelnes Lied enthält, wird dieses Lied hinzugefügt.

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

Binder sind auch das Format, das OnSong Connect zwischen Geräten sendet, wenn ein Gerät ein anderes um ein Lied oder einen Satz bittet. Das Format, das sich in Ihrer Dateien-App befindet, ist also dasselbe, das über das Netzwerk übertragen wird.

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