OnSong^® Sammelmappe

Das OnSong^® Binder-Dateiformat ist die Art, wie OnSong ein Lied, einen Song-Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archive enthält es alles, was zum Wiederherstellen des Inhalts an anderer Stelle erforderlich ist — den Songtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelnes, undurchschaubares 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, zusammen mit dem Lied selbst auf plattformunabhängige Weise zu führen.

Das OnSong^® Binder-Dateiformat hat eine Dateierweiterung von .onsongbinder oder .binder und einen MIME-Typ von application/onsong-binder.

Was ist drin

Ein Binder ist ein ZIP-Archiv. Entpacken Sie eines und Sie finden einen Ordner mit dem Namen der Artikel-ID, der Folgendes enthält:

• manifest.json — der Artikel selbst, serialisiert. Jede Eigenschaft, die OnSong über ihn kennt, in der gleichen Form, die die OnSong-Web-API verwendet.
• Seine Datei, falls vorhanden. Ein Anhang behält seinen ursprünglichen Dateinamen bei, daher ist eine PDF oder MP3 in einem Binder einfach diese PDF oder MP3.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind — songs, attachments — jeder enthält mehr Ordner genau der gleichen Form.

Diese Struktur wiederholt sich bis ganz 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 mit einem Buch aus zweihundert Liedern hat das gleiche Format wie einer mit einem einzelnen Chart.

In einem Manifest werden Verweise auf untergeordnete Elemente mit einem $binder.-Präfix gekennzeichnet, damit ein Leser den Unterschied zwischen einem Wert, der zum Artikel gehört, und einem, der auf einen Ordner daneben verweist, erkennen kann.

Was es enthält

• Lieder — das Akkorddiagramm und alles, was damit verbunden 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 verbunden sind. Sie können nur die tatsächlich verwendeten Anhänge einschließen, anstatt jede Version, die jemals hinzugefügt wurde.

Binder oder Archiv?

Beide zirkulieren den Inhalt einer Bibliothek treu, daher geht die Wahl darum, was Sie aus der Datei benötigen:

• OnSong^® Archive ist das ältere Format und sollte für Kompatibilität mit früheren Versionen von OnSong verwendet werden.
• OnSong^® Binder ist das aktuelle. Verwenden Sie es, um es mit neueren Versionen von OnSong zu teilen — und wenn Sie eine Datei wünschen, die Sie öffnen und einsehen können.

Importieren und Exportieren

Binder importieren wie jede andere Datei: Öffnen Sie eine 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 eines 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 Gerät um ein Lied oder einen Satz bittet, daher ist das gleiche Format, das in Ihrer Dateien-App vorhanden ist, das über das Netzwerk reist.

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