OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art, wie OnSong ein Lied, einen Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archiv enthält es alles Notwendige, um den Inhalt an einer anderen Stelle wiederherzustellen — den Liedtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelner undurchschaubarer Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Dies macht ihn lesbar, inspizierbar und in der Lage, die Medien, von denen ein Lied abhängt, 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. Entpacke eines und du wirst einen Ordner finden, der nach der Kennung des Elements benannt ist und folgende Inhalte hat:

• manifest.json — das Element selbst, serialisiert. Jede Eigenschaft, die OnSong darüber kennt, in derselben Form wie die OnSong Web API verwendet.
• Seine Datei, falls vorhanden. Ein Anhang behält seinen ursprünglichen Dateinamen, also ist eine PDF oder eine MP3 innerhalb eines Binders genau diese PDF oder MP3.
• Ordner für seine Unterelemente, benannt nach dem, was sie sind — songs, attachments — jeder enthält weitere Ordner genau derselben 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, der ein Buch mit zweihundert Liedern enthält, hat das gleiche Format wie einer, der ein einzelnes Chart enthält.

Innerhalb eines Manifests werden Referenzen zu Unterelementen mit einem $binder.-Präfix markiert, damit ein Leser den Unterschied zwischen einem Wert, der zum Element gehört, und einem, der in einen Ordner daneben verweist, erkennen kann.

Was es trägt

• Lieder — das Akkordiagramm und alles, das 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. Du kannst wählen, nur die tatsächlich verwendeten Anhänge einzubeziehen, anstatt jeder Version, die je hinzugefügt wurde.

Binder oder Archiv?

Beide führen den Inhalt einer Bibliothek getreu hin und her, daher geht es bei der Wahl darum, was du aus der Datei brauchst:

• OnSong^® Archiv ist das ältere Format und sollte für Kompatibilität mit früheren Versionen von OnSong verwendet werden.
• OnSong^® Binder ist das aktuelle. Verwende es zum Teilen mit neueren Versionen von OnSong — und wenn du eine Datei brauchst, die du öffnen und inspizieren kannst.

Importieren und Exportieren

Binder importieren wie jede andere Datei auch: Öffne einen aus Dateien, Mail, AirDrop oder einem Cloud-Dienst und wähle 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, verwende Teilen und wähle OnSong Binder als das 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, daher ist das gleiche Format, das sich in deiner Dateien-App befindet, das, das über das Netzwerk übertragen wird.

Da ein Binder eine ZIP-Datei aus einfachem JSON und gewöhnlichen Mediendateien ist, ist es das richtige Format, auf das du zurückgreifen solltest, wenn du sehen musst, was OnSong tatsächlich gespeichert hat — oder wenn etwas deine Inhalte lesen muss und es nicht OnSong ist.