OnSong^® Mappe

OnSong^® Binder-filformatet er hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Ligesom OnSong^® Archive indeholder det alt, hvad der skal bruges til at genskabe indholdet et andet sted — sangteksten, vedhæftelser, stilarter, indstillinger, transponering og annotationer — men hvor et arkiv er en enkelt uigennemskuelig blob, er en binder en mappe med almindelige filer. Det gør den læsbar, inspicerbar og i stand til at medtage det medie, som en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

OnSong^® Binder-filformatet har en filendelse på .onsongbinder eller .binder og en MIME-type på application/onsong-binder.

Hvad der er inde

En binder er et ZIP-arkiv. Pakk et ud, og du finder en mappe opkaldt efter varens identifikator, indeholdende:

• manifest.json — selv objektet, serialiseret. Alle egenskaber, 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 blot denne PDF eller MP3.
• Mapper for dens underordnede, opkaldt efter hvad de er — songs, attachments — hver indeholdende flere mapper af præcis samme form.

Denne 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 med en bog på to hundrede sange har samme format som en med et enkelt stykke.

Inden for et manifest er referencer til underordnede markeret med et $binder.-præfiks, så en læser kan skelne mellem en værdi, der hører til objektet, og en, der peger ind i en mappe ved siden af det.

Hvad den indeholder

• Sange — akorddiagrammet og alt, der er knyttet til det.
• Sæt — sangene i deres rækkefølge, med sættets egen arrangement.
• Bøger — en hel samling.
• Vedhæftelser — PDF'er, billeder, lyd og enhver anden fil 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 blev tilføjet.

Binder eller arkiv?

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

• OnSong^® Archive er det ældre format, og det er det, du 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 ønsker en fil, som du kan åbne og se ind i.

Import og eksport

Bindere importeres på samme måde som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en skyservice, og vælg OnSong. Import 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 denne 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, som lever i din Filer-app, er det, der rejser over netværket.

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