OnSong^® Mappe

OnSong^® Bindefilformatet er hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Som OnSong^® Archive indeholder det alt, hvad der skal til for at genopbygge indholdet et andet sted — sangteksten, vedhæftelser, stilarter, indstillinger, transponering og anmerkninger — men hvor et arkiv er en enkelt uigennemsigtig blob, er en binder en mappe med almindelige filer. Det gør det læseligt, inspicerbart og i stand til at transportere det medie, en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

OnSong^® Bindefilformatet har en filtypenavngivelse på .onsongbinder eller .binder og en MIME-type på application/onsong-binder.

Hvad der er indeni

En binder er et ZIP-arkiv. Pak en ud, og du vil finde en mappe navngivet efter elementets identifikator, indeholdende:

• manifest.json — selve elementet, serialiseret. Hver egenskab, som OnSong kender til det, i samme form som OnSong web API bruger.
• Dens fil, hvis den har en. En vedhæftelse beholder sit oprindelige filnavn, så en PDF eller en MP3 inde i en binder er netop den PDF eller MP3.
• Mapper til dens underordnede elementer, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper af præcis samme struktur.

Den 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 tohundrede sange, er det samme format som en, der indeholder et enkelt diagram.

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

Hvad det indeholder

• Sange — akkorddiagrammet 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 enhver anden fil, 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 blevet tilføjet.

Binder eller arkiv?

Begge sender et biblioteks indhold tilbage trofast, så valget handler om, hvad du har brug for fra filen:

• OnSong^® Archive er det ældre format, og er hvad man skal bruge til kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er det nuværende. Brug det til at dele med nyere versioner af OnSong — og når du vil have en fil, du kan åbne og se ind i.

Importering og eksportering

Bindere importeres som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste, og vælg OnSong. Import af en binder, der indeholder et sæt, genskaberr sættet og hver sang i det; import af en, der indeholder en enkelt sang, tilføjer den 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 den ene enhed beder den anden om en sang eller et sæt, så det samme format, som findes i din Filer-app, er det, der rejser over netværket.

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