OnSong^® Mappe

OnSong^® Binderfilformatet er hvordan OnSong flytter en sang, et sett eller en hele bok mellom biblioteker. Som OnSong^® Archive inneholder det alt som trengs for å gjenoppbygge innholdet andre steder — sangteksten, vedlegg, stiler, innstillinger, transponering og merknader — men mens et arkiv er en enkelt ugjennomskinnelig blob, er en binder en mappe med ordinære filer. Det gjør den lesbar, inspiserbar, og i stand til å bære mediafilen 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 det ut og du finner en mappe oppkalt etter gjenstandens identifikator, som inneholder:

• manifest.json — gjenstanden selv, serialisert. Alle egenskaper OnSong kjenner om den, i samme form OnSong web API bruker.
• Dens fil, hvis den har en. Et vedlegg beholder sitt opprinnelige filnavn, så en PDF eller en MP3 inne i en binder er bare den PDF-en eller MP3-en.
• Mapper for dens barn, oppkalt etter hva de er — songs, attachments — hver inneholdende flere mapper av nøyaktig samme form.

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

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

Hva det bærer

• Sanger — akkordarket og alt som er knyttet til det.
• Sett — sangene i rekkefølgen deres, med setets egen arrangement.
• Bøker — en helt samling.
• Vedlegg — PDF-er, bilder, lyd og alle andre filer assosiert 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 bibliotekinnholdet troverdig, 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 den nåværende. Bruk den for deling med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se inne i.

Import og eksport

Bindere importeres som alle andre filer gjør: åpne en fra Filer, Mail, AirDrop, eller en skytjeneste og velg OnSong. Å importere en binder som holder et sett gjenoppretter settet og hver sang i det; importering av en som holder en enkelt sang legger til den sangen.

For å lage en, bruk Del og velg OnSong Binder som formatet.

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

Fordi en binder er en ZIP av ren JSON og ordinære mediafiler, er det det riktige formatet å gripe til når du trenger å se hva OnSong faktisk lagret — eller når noe trenger å lese innholdet ditt og ikke er OnSong.