OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Methode, mit der OnSong ein Lied, einen Satz oder ein ganzes Buch zwischen Bibliotheken bewegt. Wie das OnSong^® Archive 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, inspizierbar 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 .onsongbinder oder .binder und einen MIME-Typ von application/onsong-binder.

Was ist enthalten

Ein Binder ist ein ZIP-Archiv. Entpacken Sie einen und Sie finden 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, 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 einfach diese PDF- oder MP3-Datei ist.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind — songs, attachments — jeweils mit weiteren Ordnern der gleichen Struktur.

Diese Struktur wiederholt sich bis nach 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 mit einem 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 in einen Ordner daneben zeigt, erkennen kann.

Was es trägt

• Lieder — das Akkorddiagramm und alles, was daran befestigt 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 auswählen, dass nur die tatsächlich verwendeten Anhänge einbezogen werden, anstatt jeder jemals hinzugefügten Version.

Binder oder Archiv?

Beide transportieren den Inhalt einer Bibliothek zuverlässig hin und zurück, 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 für die Freigabe mit neueren Versionen von OnSong — und wenn Sie eine Datei benötigen, die Sie öffnen und inspizieren können.

Importieren und Exportieren

Binder werden wie alle anderen Dateien importiert: Öffnen Sie einen aus „Dateien", „Mail", AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der einen Satz enthält, erstellt den Satz 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 Freigabe 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 einen Satz bittet, sodass das gleiche Format, das sich in Ihrer „Dateien"-App befindet, das über das Netzwerk übertragene Format ist.

Da ein Binder eine ZIP-Datei aus 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.