OnSong^® Binder

OnSong^® Binderfilformat er, hvordan OnSong flytter en sang, et sæt eller en hel bog mellem biblioteker. Ligesom OnSong^® Archive indeholder det alt, hvad der skal til for at genopbygge indholdet andetsteds — sangteksten, vedhæftelser, stilarter, indstillinger, transponering og anmærkninger — 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 bære de medier, som en sang afhænger af sammen med sangen selv på en platformuafhængig måde.

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

Hvad der er indvendigt

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

• manifest.json — selve varen, serialiseret. Hver egenskab, som OnSong kender til den, i samme form som OnSong web-API'en bruger.
• Dens fil, hvis den har en. En vedhæftelse holder sit oprindelige filnavn, så en PDF eller en MP3 indeni en binder er lige netop den PDF eller MP3.
• Mapper for dens underordnede, navngivet 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 samme format som en, der indeholder et enkelt stykke.

Inden i et manifest er referencer til underordnede markeret med et $binder. præfiks, så en læser kan se forskel på en værdi, der tilhører varen, og en, der peger ind i en mappe ved siden af den.

Hvad det bærer

• Sange — akkorddiagrammet og alt, hvad der er knyttet til det.
• Sæt — sangene i deres rækkefølge, med sættets eget arrangement.
• Bøger — en hele samling.
• Vedhæftelser — PDF'er, billeder, lyd og alle andre filer, der er knyttet til en sang. Du kan vælge kun at medtage de vedhæftelser, der faktisk er i brug, i stedet for alle versioner, der nogensinde er tilføjet.

Binder eller arkiv?

Begge rundturer et biblioteks indhold trofast, 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 den aktuelle. Brug den til deling med nyere versioner af OnSong — og når du ønsker en fil, som du kan åbne og se indeni.

Import og eksport

Bindere importeres på samme måde som alle andre filer: åbn en fra Filer, Mail, AirDrop eller en skyjeneste 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 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 beder 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 almindelige mediefiler, er det det rigtige format at tage i brug, 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.