OnSong^® Samling

OnSong^® Bindemappe-filformatet 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 enkel ugjennomsiktig blob, er en bindemappe en mappe med vanlige filer. Det gjør den lesbar, inspiserbar og i stand til å bære mediefiler som en sang er avhengig av sammen med sangen selv på en plattformuavhengig måte.

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

Hva som er inne

En bindemappe er et ZIP-arkiv. Pakk ut en og du finner en mappe oppkalt etter varens identifikator, som inneholder:

• manifest.json — selve gjenstanden, serialisert. Hver egenskap OnSong kjenner til den, i samme form som OnSong web API bruker.
• Dens fil, hvis den har en. Et vedlegg beholder sitt originale filnavn, så en PDF eller en MP3 inne i en bindemappe er bare den PDF-en eller MP3-en.
• Mapper for dens underordnede elementer, oppkalt etter hva de er — songs, attachments — hver med flere mapper av nøyaktig samme struktur.

Denne 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 bindemappe som holder en bok på to hundre sanger har samme format som en som holder ett enkelt diagram.

Inne i et manifest er referanser til underordnede elementer markert med et $binder. prefiks, slik at en leser kan se forskjellen mellom en verdi som tilhører gjenstanden og en som peker inn i en mappe ved siden av den.

Hva den bærer

• Sanger — akkordiagrammet og alt som er knyttet til 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 knyttet til en sang. Du kan velge å inkludere bare vedleggene som faktisk er i bruk i stedet for hver versjon som noen gang er lagt til.

Bindemappe eller arkiv?

Begge rundeturer til et biblioteks innhold trofast, så valget handler om hva du trenger fra filen:

• OnSong^® Archive er det eldre formatet, og er det som skal brukes for kompatibilitet med tidligere versjoner av OnSong.
• OnSong^® Bindemappe er det nåværende. Bruk det til deling med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se på innsiden av.

Importering og eksportering

Bindekapper importeres som hvilken som helst annen fil: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Importering av en bindemappe som inneholder et sett gjenskaper settet og hver sang i det; importering av en som inneholder en enkelt sang legger til den sangen.

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

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

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