OnSong^® Binder

OnSong^® Binderfilformatet er hvordan OnSong flytter en sang, et sett eller en hel bok mellom biblioteker. Som OnSong^® Archive inneholder det alt som trengs for å gjenopprette innholdet et annet sted — sangteksten, vedlegg, stiler, innstillinger, transponering og merknader — men mens et arkiv er en enkelt ugjennomsiktig blob, er en binder en mappe med vanlige filer. Det gjør den lesbar, inspiserbar og i stand til å bære mediene en sang er avhengig av sammen med sangen selv på en plattformuavhengig måte.

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

Hva som er inni

En binder er et ZIP-arkiv. Pakk ut en og du vil finne en mappe med navn etter elementets identifikator, som inneholder:

• manifest.json — selve elementet, serialisert. Hver egenskap OnSong kjenner til det, i samme form som OnSong web API bruker.
• Dens fil, hvis den har en. Et vedlegg beholder sitt opprinnelige filnavn, så en PDF eller en MP3 inni en binder er bare det PDF-en eller MP3-en.
• Mapper for dets underordnede elementer, navngitt etter hva de er — songs, attachments — hver inneholder flere mapper av nøyaktig samme form.

Denne strukturen gjentas hele veien ned: et sett inneholder sanger, en sang inneholder vedlegg, og hver har en mappe med sitt eget manifest ved siden av sine egne filer. En binder som inneholder en bok med to hundre sanger er samme format som en som inneholder et enkelt notat.

Inni et manifest merkes referanser til underordnede elementer med et $binder. prefiks, så en leser kan se forskjellen mellom en verdi som tilhører elementet og en som peker til en mappe ved siden av det.

Hva det inneholder

• Sanger — akkordiagrammet og alt som er vedlagt det.
• Sett — sangene i deres rekkefølge, med settet sitt eget arrangement.
• Bøker — en hel samling.
• Vedlegg — PDF-er, bilder, lyd og alle andre filer forbundet med en sang. Du kan velge å inkludere bare vedleggene som faktisk er i bruk i stedet for hver versjon som noen gang ble lagt til.

Binder eller arkiv?

Begge gjengir et biblioteks innhold tro, så valget handler om hva du trenger fra filen:

• OnSong^® Archive er det eldre formatet, og er hva du skal bruke for kompatibilitet med tidligere versjoner av OnSong.
• OnSong^® Binder er det nåværende. Bruk det til å dele med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se inni.

Importering og eksportering

Bindere importeres på samme måte som alle andre filer gjør: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Importering av en binder som inneholder et sett gjenoppretter settet og alle sangene i det; importering av en som inneholder en enkelt sang legger til den sangen.

For å opprette en, bruk Del og velg OnSong Binder som format.

Bindere er også hva OnSong Connect sender mellom enheter når en enhet ber en annen om en sang eller et sett, så samme format som er i Filer-appen er det som reiser over nettverket.

Fordi en binder er en ZIP av enkel JSON og vanlige mediefiler, er det riktig format å velge når du må se hva OnSong faktisk lagret — eller når noe trenger å lese innholdet ditt og ikke er OnSong.