OnSong^® Binder

OnSong^® Binderfilformatet er hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Som OnSong^® Archive indeholder det alt, hvad der er nødvendigt for at genopbygge indholdet andre steder — sangteksten, vedhæftede filer, stilarter, indstillinger, transponering og annotationer — 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 føre det medie, en sang er afhængig af, sammen med sangen selv på en platformuafhængig måde.

OnSong^® Binderfilformatet har en filtypenavn på enten .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 finder en mappe opkaldt efter elementets identifikator, indeholdende:

• manifest.json — elementet selv, serialiseret. Alle egenskaber OnSong kender til det, i samme form som OnSong web API bruger.
• Dens fil, hvis den har en. En vedhæftet fil beholder sit oprindelige filnavn, så en PDF eller en MP3 indeni en binder er blot den PDF eller MP3.
• Mapper for dets børn, opkaldt efter hvad de er — songs, attachments — hver indeholdende flere mapper af præcis samme struktur.

Den struktur gentages helt ned: et sæt indeholder sange, en sang indeholder vedhæftede filer, 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 akkordskema.

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

Hvad det indeholder

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

Binder eller arkiv?

Begge rundgiver et biblioteks indhold troværdigt, 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 aktuelle. Brug det til at dele med nyere versioner af OnSong — og når du ønsker en fil, du kan åbne og se indeni.

Import og eksport

Bindere importeres på samme måde som enhver anden fil: åben en fra Filer, Mail, AirDrop eller en cloudtjeneste, og vælg OnSong. Import af en binder, der indeholder et sæt, gendanner 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 Deling og vælge OnSong Binder som formatet.

Bindere er også hvad OnSong Connect sender mellem enheder, når en enhed spørger 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 en ZIP af almindelig JSON og ordinære mediefiler, er det det rigtige format at gå efter, når du skal se, hvad OnSong faktisk lagrede — eller når noget skal læse dit indhold, og det ikke er OnSong.