OnSong^® Binder

OnSong^® Binderfilformatet er sådan, OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Som OnSong^® Archive indeholder det alt det, der skal til for at genskabe indholdet et andet sted — sangenes tekst, vedhæftelser, 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 den læsbar, inspicerbar og i stand til at bære de medier, en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

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

Hvad der er indeni

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

• manifest.json — selve varen, serialiseret. Alle egenskaber, OnSong kender til det, i samme form som OnSong web API'en 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 bare den 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 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 to hundrede sange, har det samme format som en, der indeholder et enkelt diagram.

Inde i et manifest er referencer til underordnede markeret 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 indeholder

• Sange — akkordiagrammet 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 medtage kun de vedhæftelser, der faktisk er i brug, i stedet for enhver version, der nogensinde er blevet tilføjet.

Binder eller arkiv?

Begge rundturer et biblioteks indhold trofast, så valget handler om hvad du skal bruge fra filen:

• OnSong^® Archive er det ældre format og er det, der skal bruges til 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, du kan åbne og kigge ind i.

Importering og eksportering

Bindere importeres som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en skylagringstjeneste og vælg OnSong. Importering af en binder, der indeholder et sæt, genskaber sættet og hver sang i det; 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 formatet.

Bindere er også det, som OnSong Connect sender mellem enheder, når en enhed spørger en anden enhed efter en sang eller et sæt, så det samme format, der findes 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 til, når du har brug for at se, hvad OnSong faktisk gemte — eller når noget skal læse dit indhold, og det ikke er OnSong.