OnSong^® Mappe

OnSong^® Binder-filformatet er, hvordan OnSong flytter en sang, et sæt eller hele bogen mellem biblioteker. Ligesom OnSong^® Archive indeholder det alt, hvad der skal til for at genopbygge indholdet et andet sted — sangteksten, vedhæftede filer, 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 det medie, en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

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

Hvad der er inden i

En binder er et ZIP-arkiv. Udpak en, og du finder en mappe med navnet på elementets identifikator, indeholdende:

• manifest.json — elementet selv, serialiseret. Alle egenskaber, som OnSong kender til det, i samme form som OnSong-webapiét bruger.
• Dets fil, hvis den har en. En vedhæftet fil beholder sit oprindelige filnavn, så en PDF eller en MP3 inden i en binder er bare den PDF eller MP3.
• Mapper til dets underordnede elementer, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper med præcis samme struktur.

Denne struktur gentager sig hele vejen ned: et sæt indeholder sange, en sang indeholder vedhæftede filer, 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 nummer.

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

Hvad den bærer

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

Binder eller Archive?

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

• OnSong^® Archive er det ældre format, og er det, du skal bruge for kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er det aktuelle. Brug det til at dele med nyere versioner af OnSong — og når du ønsker en fil, du kan åbne og se inden i.

Importering og eksportering

Bindere importeres på samme måde som enhver anden fil: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste, 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å det, som OnSong Connect sender mellem enheder, når den ene enhed anmoder en anden om 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 nå efter, 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.