OnSong^® Mappe

OnSong^® Binder-filformatet er, hvordan OnSong flytter en sang, et sæt eller en hele bog mellem biblioteker. Ligesom OnSong^® Archive indeholder det alt, hvad der skal til for at genopbygge indholdet et andet sted — sangteksten, vedhæftelser, stile, indstillinger, transponering og annotationer — men hvor et arkiv er en enkelt uigennemsigtig blob, er en binder en mappe med almindelige filer. Det gør den læsbar, inspicerbar og i stand til at bære det medie, en sang afhænger af, ved siden af sangen selv på en platformuafhængig måde.

OnSong^® Binder-filformatet har en filendelse på enten .onsongbinder eller .binder, og en MIME-type på application/onsong-binder.

Hvad er indeni

En binder er et ZIP-arkiv. Pak en ud, og du finder en mappe opkaldt efter elementets identifikator, der indeholder:

• manifest.json — selve elementet, serialiseret. Alle egenskaber, som OnSong kender til det, i samme form som OnSong web API anvender.
• Dens fil, hvis den har en. En vedhæftelse bevarer sit oprindelige filnavn, så en PDF eller MP3 indeni en binder er blot denne PDF eller MP3.
• Mapper for dets underordnede elementer, opkaldt efter hvad de er — songs, attachments — hver især indeholdende flere mapper af præcis samme struktur.

Denne struktur gentages hele vejen ned: et sæt indeholder sange, en sang indeholder vedhæftelser, og hver er en mappe med sit eget manifest ved siden af sine egne filer. En binder, der indeholder en bog med to hundrede sange, har samme format som en, der indeholder et enkelt nodesystem.

Inden i et manifest markeres referencer til underordnede elementer med et $binder. præfiks, så en læser kan skelne mellem en værdi, der tilhører elementet, og en, der peger til en mappe ved siden af det.

Hvad den indeholder

• Sange — akkordsystemet og alt, hvad der er knyttet til det.
• Sæt — sangene i deres rækkefølge, med sættets eget arrangement.
• Bøger — en hel samling.
• Vedhæftelser — PDF'er, billeder, lyd og alle andre filer, der er knyttet til en sang. Du kan vælge at inkludere kun de vedhæftelser, der faktisk er i brug, i stedet for hver version, der nogensinde er tilføjet.

Binder eller arkiv?

Begge gemmer et biblioteks indhold trofast på tur-retur, så valget handler om, hvad du har brug for fra filen:

• OnSong^® Archive er det ældre format, og er det, du skal bruge til kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er den aktuelle. Brug det til deling med nyere versioner af OnSong — og når du ønsker en fil, du kan åbne og kigge indeni.

Import og eksport

Bindere importeres på samme måde som alle andre filer: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste, og vælg OnSong. Import af en binder, der indeholder et sæt, genskaber sættet og hver sang i det; import af en, der indeholder en enkelt sang, tilføjer denne sang.

For at oprette en skal du bruge Del og vælge OnSong Binder som format.

Bindere er også det, som OnSong Connect sender mellem enheder, når én enhed beder en anden om en sang eller et sæt, så samme format, der ligger i din Filer-app, er det, der rejser over netværket.

Fordi en binder er en ZIP med almindelig JSON og normale mediefiler, er det det rigtige format at vælge, når du skal se, hvad OnSong faktisk lagrede — eller når noget skal læse dit indhold og ikke er OnSong.