OnSong^® Mappe

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 å gjenoppbygge innholdet et annet sted — sangteksten, vedlegg, stiler, innstillinger, transponering og merknader — men der 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 ved siden av sangen selv på en plattformagnostisk 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 finner en mappe oppkalt etter elementets identifikator, som inneholder:

• manifest.json — selve elementet, serialisert. Alle egenskaper 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 den PDF-en eller MP3-en.
• Mapper for dens barn, oppkalt etter hva de er — songs, attachments — hver med flere mapper av nøyaktig samme form.

Den strukturen gjentar seg 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 tohundre sanger har samme format som en som inneholder ett enkelt skjema.

Inne i et manifest er referanser til barn merket med et $binder. prefiks, så en leser kan skille mellom en verdi som tilhører elementet og en som peker inn i en mappe ved siden av det.

Hva den bærer

• Sanger — akkordsystemet og alt som er festet til det.
• Sett — sangene i deres rekkefølge, med settet sitt eget arrangement.
• Bøker — en hel samling.
• Vedlegg — PDFer, bilder, lyd og hvilken som helst annen fil knyttet til 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 gjør bibliotekinnholdet på pålitelig måte tur-retur, så valget handler om hva du trenger fra filen:

• OnSong^® Archive er det eldre formatet, og er det du skal bruke for kompatibilitet med tidligere versjoner av OnSong.
• OnSong^® Binder er det gjeldende formatet. Bruk det for deling med nyere versjoner av OnSong — og når du ønsker en fil du kan åpne og se inni.

Import og eksport

Bindere importeres som hvilken som helst annen fil: åpne en fra Filer, E-post, AirDrop eller en skytjeneste og velg OnSong. Import av en binder som inneholder et sett gjenskaper settet og hver sang i det; import av en som inneholder en enkelt sang legger til den sangen.

For å opprette en bruker du Del og velger 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å det samme formatet som bor i Filer-appen er det som reiser over nettverket.

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