OnSong^® Mappe

OnSong^® Binderfilformatet er, hvordan OnSong flytter en sang, et sæt eller en hele bog mellem biblioteker. Som OnSong^® Archive indeholder det alt, hvad der skal til for at genopbygge indholdet et andet sted — sangsteksten, vedhæftelser, stilarter, indstillinger, transponering og anmærkninger — men hvor et arkiv er en enkelt uigennemsigtig klump, er en binder en mappe med almindelige filer. Det gør det læseligt, inspicerbart og i stand til at transportere det medie, som en sang afhænger 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 navngivet efter varen's identifikator, indeholdende:

• manifest.json — varen selv, 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 indeni en binder er blot den PDF eller MP3.
• Mapper til dens børn, navngivet efter hvad de er — songs, attachments — hver holdende flere mapper af nøjagtig samme form.

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 holder en bog med to hundrede sange, er det samme format som en, der holder et enkelt diagram.

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 varen, og en, der peger ind i en mappe ved siden af den.

Hvad det transporterer

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

Binder eller arkiv?

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

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

Import og eksport

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 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å 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 plain JSON og almindelige mediefiler, er det det rigtige format at nå til, når du har brug for at se, hvad OnSong faktisk gemte — eller når noget har brug for at læse dit indhold, og det ikke er OnSong.