OnSong^® Mappe

OnSong^® Binderfilformatet 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 et andet sted — sanglyrik, vedhæftninger, stilarter, indstillinger, transponering og anmærkninger — 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 det medie, en sang er afhængig af, sammen med sangen selv på en platformuafhængig måde.

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

Hvad der er indeholdt

En binder er et ZIP-arkiv. Pak én ud, og du finder en mappe navngivet efter elementets identifikator, der indeholder:

• manifest.json — selve elementet, serialiseret. Alle egenskaber, som OnSong kender til det, i den samme form, som OnSong web-API'en bruger.
• Dens fil, hvis den har en. En vedhæftning beholder sitt oprindelige filnavn, så en PDF eller en MP3 inden for en binder er bare den PDF eller MP3.
• Mapper til dens underordnede elementer, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper af præcis samme form.

Den struktur gentager sig helt ned: et sæt indeholder sange, en sang indeholder vedhæftninger, 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 én, der indeholder et enkelt leadsheet.

Inden for 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 elementet, og en der peger ind i en mappe ved siden af det.

Hvad den indeholder

• Sange — akkorddiagrammet og alt, der er vedhæftet til det.
• Sæt — sangene i deres rækkefølge med sættets egen arrangement.
• Bøger — en hel samling.
• Vedhæftninger — PDF'er, billeder, lyd og alle andre filer, der er tilknyttet en sang. Du kan vælge kun at medtage de vedhæftninger, der faktisk bruges, i stedet for hver version, der nogensinde er tilføjet.

Binder eller arkiv?

Begge gemmer et biblioteks indhold troværdigt, så valget handler om, hvad du har brug for fra filen:

• OnSong^® Archive er det ældre format, og er hvad du skal bruge for kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er det nuværende. Brug det, når du deler med nyere versioner af OnSong — og når du ønsker en fil, du kan åbne og kigge ind i.

Import og eksport

Bindere importeres som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en skybaseret tjeneste 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.

Hvis du vil 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 ligger i din Filer-app, er det, der rejser over netværket.

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