OnSong^® Mappe

OnSong^® Binderfilformatet er hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Ligesom OnSong^® Arkivet indeholder det alt hvad der skal til for at genopbygge indholdet andre steder — sangteksten, vedhæftninger, styles, 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, sammen med sangen selv på en platformuafhængig måde.

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

Hvad indeholder den

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

• manifest.json — elementet selv, serialiseret. Hver egenskab OnSong kender til det, i samme form som OnSong web API'en bruger.
• Dens fil, hvis den har en. En vedhæftning beholder sit oprindelige filnavn, så en PDF eller en MP3 inde i en binder er bare netop den PDF eller MP3.
• Mapper for dens børn, navngivet efter hvad de er — songs, attachments — hver holdt flere mapper af præcis samme form.

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

Inde i et manifest er referencer til børn markeret med et $binder. præfiks, så en læser kan se forskellen mellem en værdi der hører til elementet og en der peger ind i en mappe ved siden af det.

Hvad det bærer

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

Binder eller arkiv?

Begge rundt-kørsel af et biblioteks indhold trofast, så valget handler om hvad du skal bruge fra filen:

• OnSong^® Arkiv er det ældre format, og er hvad man skal bruge for 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 se inden i.

Import og eksport

Bindere importeres som andre filer: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste og vælg OnSong. Import af en binder der holder et sæt genskabt sættet og hver sang i det; import af en der holder en enkelt sang tilføjer den pågældende sang.

For at oprette en skal du bruge Del og vælg OnSong Binder som formatet.

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

Fordi en binder er et ZIP af almindelig JSON og almindelige mediefiler, er det det rigtige format at nå efter når du skal se hvad OnSong faktisk gemte — eller når noget skal læse dit indhold og det ikke er OnSong.