OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, ein Set 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 einzelnes undurchsichtiges Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Dies macht ihn lesbar, überprüfbar und fähig, die Medien, von denen ein Lied abhängt, zusammen mit 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 drin?

Ein Binder ist ein ZIP-Archiv. Wenn Sie einen entpacken, finden Sie einen Ordner, der nach der Kennung des Elements benannt ist und 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, sodass eine PDF- oder MP3-Datei in einem Binder genau diese PDF- oder MP3-Datei ist.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind – songs, attachments – jeder enthält weitere Ordner mit genau der gleichen Struktur.

Diese Struktur wiederholt sich bis hinunter: Ein Set 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 einer mit einer einzelnen Chart.

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

Was es trägt

• Lieder – die Akkord-Chart und alles, was damit verbunden ist.
• Sets – die Lieder in ihrer Reihenfolge mit der eigenen Anordnung des Sets.
• 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 geben den Inhalt einer Bibliothek zuverlässig hin und her, daher hängt die Wahl davon ab, was Sie aus der Datei benötigen:

• OnSong^® Archiv 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 wünschen, die Sie öffnen und ansehen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie einen über Dateien, Mail, AirDrop oder einen Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der ein Set enthält, erstellt das Set und jedes Lied darin erneut; 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 ein anderes um ein Lied oder ein Set bittet. Das gleiche Format, das sich in Ihrer Dateien-App befindet, ist daher das Format, das über das Netzwerk übertragen wird.

Da ein Binder ein ZIP von einfachem JSON und gewöhnlichen Mediendateien ist, ist dies 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.