OnSong^® Mappe

OnSong^® Binderfilformatet er hvordan OnSong flytter en sang, et sæt eller en helt bog mellem biblioteker. Som OnSong^® Archive indeholder det alt, hvad der er nødvendigt for at genopbygge indholdet andre steder — sangenes tekst, vedhæftelser, typografier, indstillinger, transponering og anmerkninger — 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 de mediefiler, som en sang afhænger af, sammen med sangen selv på en platformuafhængig måde.

OnSong^® Binderfilformatet har en filendelse på enten .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, der indeholder:

• manifest.json — elementet selv, serialiseret. Alle egenskaber, som OnSong kender til det, i samme format som OnSong-web-API'en bruger.
• Dens fil, hvis den har en. En vedhæftelse bevarer sit oprindelige filnavn, så en PDF eller en MP3 indeni en binder er bare netop den PDF eller MP3.
• Mapper for dets underordnede elementer, navngivet efter hvad de er — songs, attachments — hver indeholdende flere mapper af præcis samme struktur.

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 med en bog på tohundrede sange har samme format som en, der indeholder et enkelt nummer.

Indeni en manifest er referencer til underordnede elementer markeret med præfikset $binder., 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 — akkorddiagrammet og alt, der er vedhæftet til det.
• Sæt — sangene i deres rækkefølge med sættets eget arrangement.
• Bøger — en helt samling.
• Vedhæftelser — PDF'er, billeder, lyd og andre filer forbundet med en sang. Du kan vælge kun at medtage de vedhæftelser, der faktisk bruges, i stedet for enhver version, der nogensinde er blevet tilføjet.

Binder eller arkiv?

Begge gemmer og gendanner 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 nuværende. Brug det til deling 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 alle andre filer: åbn en fra Filer, Mail, AirDrop eller en cloudtjeneste og vælg OnSong. Import af en binder, der indeholder et sæt, genskaberudsætter sættet og enhver 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å det, som OnSong Connect sender mellem enheder, når en enhed anmoder en anden om en sang eller et sæt, så det samme format, der ligger i din Filer-app, er det, der rejser gennem netværket.

Fordi en binder er et ZIP-arkiv med plain JSON og almindelige mediefiler, er det det rigtige format at gå efter, når du har brug for at se, hvad OnSong faktisk gemte — eller når noget skal læse dit indhold og ikke er OnSong.