OnSong^® Mappe

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

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

Hvad er indeholdt

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

• manifest.json — selve elementet, serialiseret. Hver egenskab, som OnSong kender til det, i samme form som OnSong web API bruger.
• Dens fil, hvis den har en. En vedhæftet fil beholder sit oprindelige filnavn, så en PDF eller en MP3 inden for en binder er bare netop denne PDF eller MP3.
• Mapper for dens underordnede elementer, 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æftede filer, og hver er en mappe med sit eget manifest ved siden af sine egne filer. En binder, der holder en bog med to hundrede sange, er samme format som en, der holder et enkelt diagram.

Inden for et manifest er referencer til underordnede elementer markeret 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 bærer

• Sange — akkordiagrammet og alt, hvad 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æftede filer — PDF-filer, billeder, lyd og andre filer, der er knyttet til en sang. Du kan vælge at medtage kun de vedhæftede filer, der er i brug, i stedet for hver version, der nogensinde er blevet 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 det er hvad du skal bruge for kompatibilitet med tidligere versioner af OnSong.
• OnSong^® Binder er den nuværende. Brug den til at dele med nyere versioner af OnSong — og når du ønsker en fil, 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 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 formatet.

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 ligger 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å til, når du skal se, hvad OnSong faktisk lagde op — eller når noget skal læse dit indhold, og det er ikke OnSong.