OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong einen Song, ein Set 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 Songtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen – aber während ein Archive ein einzelner undurchsichtiger Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Dies macht ihn lesbar, überprüfbar und in der Lage, die Medien, von denen ein Song abhängig ist, neben dem Song selbst auf plattformunabhängige Weise zu transportieren.

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 einen und Sie finden einen Ordner mit dem Namen der Elementkennung, der 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 einfach diese PDF- oder MP3-Datei ist.
• Ordner für seine untergeordneten Elemente, benannt nach ihrem Typ – songs, attachments – jeder mit weiteren Ordnern mit genau der gleichen Struktur.

Diese Struktur wiederholt sich bis ganz nach unten: Ein Set enthält Songs, ein Song enthält Anhänge, und jedes ist ein Ordner mit seinem eigenen Manifest neben seinen eigenen Dateien. Ein Binder, das ein Buch mit zweihundert Songs 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 markiert, 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 enthält

• Songs – das Akkordblatt und alles, was damit verbunden ist.
• Sets – die Songs 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 Song verbunden sind. Sie können wählen, nur die tatsächlich verwendeten Anhänge einzubeziehen, anstatt jede jemals hinzugefügte Version.

Binder oder Archive?

Beide transportieren den Inhalt einer Bibliothek getreu, 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. Verwenden Sie es, um es mit neueren Versionen von OnSong zu teilen – und wenn Sie eine Datei möchten, die Sie öffnen und inspizieren können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie einen aus Dateien, Mail, AirDrop oder einem Cloud-Service und wählen Sie OnSong. Das Importieren eines Binders, das ein Set enthält, erstellt das Set und jeden darin enthaltenen Song erneut; das Importieren eines, das einen einzelnen Song enthält, fügt diesen Song 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 Gerät um einen Song oder ein Set bittet. Das gleiche Format, das sich in Ihrer Dateien-App befindet, ist also 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, wenn Sie sehen möchten, was OnSong tatsächlich gespeichert hat – oder wenn etwas Ihren Inhalt lesen muss und es nicht OnSong ist.