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 er nødvendigt for at genopbygge indholdet andre steder — sangteksten, vedhæftede filer, 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 det læseligt, inspicer-bart og i stand til at medtage de medier, som en sang er afhængig af, sammen med sangen selv på en platformuafhængig måde.

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

Hvad der er indeni

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

• manifest.json — selve elementet, serialiseret. Alle egenskaber, som OnSong kender til det, i den 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 i en binder er blot den pågældende PDF eller MP3.
• Mapper for dets underordnede elementer, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper med præcis samme struktur.

Den 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 indeholder en bog med to hundrede sange, har samme format som en, der indeholder et enkelt diagram.

I et 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 det indeholder

• 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'er, billeder, lyd og andre filer forbundet med en sang. Du kan vælge kun at inkludere de vedhæftede filer, der faktisk er i brug, i stedet for alle versioner, der nogensinde er tilføjet.

Binder eller arkiv?

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

• OnSong^® Archive er det ældre format, og er det, man bør 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, som du kan åbne og se inde i.

Import og eksport

Bindere importeres på samme måde som andre filer: åbn en fra Filer, Mail, AirDrop eller en cloud-tjeneste, og vælg OnSong. Hvis du importerer en binder, der indeholder et sæt, genskabes sættet og alle sangene i det; hvis du importerer en, der indeholder en enkelt sang, tilføjes den pågældende sang.

For at skabe en, skal du bruge Del og vælge OnSong Binder som format.

Bindere er også hvad OnSong Connect sender mellem enheder, når den ene enhed beder den anden om en sang eller et sæt, så det samme format, der bor i din Filer-app, er det, der rejser over netværket.

Fordi en binder er et ZIP af almindelig JSON og almindelige mediefiler, er det det rigtige format at bruge, 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.