OnSong^® Mappe

OnSong^® Binderfilformatet er, hvordan OnSong flytter en sang, et sæt eller en helt bog mellem biblioteker. Ligesom OnSong^® Arkivet indeholder det alt, hvad der er nødvendigt for at genopbygge indholdet et andet sted — sangenes tekst, vedhæftelser, stilarter, indstillinger, transponering og annotationer — men hvor et arkiv er en enkelt uigennemskuelig klump, er en binder en mappe med almindelige filer. Det gør det læseligt, inspicerbart og i stand til at transportere de medier, som en sang afhænger af, sammen med sangen selv på en platformsuafhængig måde.

OnSong^® Binderfilformatet har en filtypenavnendelse på .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 varens identifikator, som indeholder:

• manifest.json — selve varen, serialiseret. Hver egenskab OnSong kender til den, 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 indeni en binder er blot den PDF eller MP3.
• Mapper for dens underordnede elementer, opkaldt efter hvad de er — songs, attachments — hver holding flere mapper af nøjagtigt samme form.

Den struktur gentager sig 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 akkordskema.

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

Hvad det transporterer

• Sange — akkordskemaet og alt, der er tilknyttet det.
• Sæt — sangene i deres rækkefølge med sættets eget arrangement.
• Bøger — en helt samling.
• Vedhæftelser — PDF'er, billeder, lyd og andre filer, der er tilknyttet 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 gør et biblioteks indhold til og fra pålidelig, så valget handler om, hvad du har brug for fra filen:

• OnSong^® Arkivet er det ældre format, og er det, man skal bruge for kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er det nuværende. Brug det til deling med nyere versioner af OnSong — og når du gerne vil have en fil, som du kan åbne og kigge ind i.

Importering og eksportering

Bindere importeres som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste, og vælg OnSong. Importering af en binder, der indeholder et sæt, genskaber sættet og alle sangene deri; importering 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 en enhed beder en anden om en sang eller et sæt, så det samme format, der ligger i din Filer-app, er det, der rejser over netværket.

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