OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist der Weg, auf dem OnSong ein Lied, eine Zusammenstellung oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archive enthält es alles, was nötig ist, um den Inhalt an anderer Stelle wiederherzustellen — 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. Das macht ihn lesbar, inspizierbar und in der Lage, die Medien, von denen ein Lied abhängt, zusammen mit 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. Entzippen Sie eines und Sie finden einen Ordner, der nach der Kennung des Elements benannt ist, enthaltend:

• 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 enthält weitere Ordner mit genau der gleichen Struktur.

Diese Struktur wiederholt sich durchgehend: Eine Zusammenstellung 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, der einen einzelnen Song hält.

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 zeigt, erkennen kann.

Was es transportiert

• Lieder — das Akkorddiagramm und alles, was damit verbunden ist.
• Zusammenstellungen — die Lieder in ihrer Reihenfolge, mit der Anordnung der Zusammenstellung.
• 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 einzuschließen, die tatsächlich verwendet werden, anstatt jede jemals hinzugefügte Version.

Binder oder Archiv?

Beide geben den Inhalt einer Bibliothek getreu zurück, daher geht es bei der Wahl darum, 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 Format. Verwenden Sie es zum Teilen mit neueren Versionen von OnSong — und wenn Sie eine Datei möchten, die Sie öffnen und durchschauen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie eine aus Dateien, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der eine Zusammenstellung enthält, erstellt die Zusammenstellung und jedes Lied darin erneut; 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 Zusammenstellung fragt, sodass das gleiche Format, das in Ihrer Dateien-App vorhanden ist, das über das Netzwerk reist.

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