OnSong^® Mappemappe

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 hvor et arkiv er en enkelt ugjennomsiktig blob, er en bindemappe en mappe med vanlige filer. Det gjør den lesbar, kontrollerbar og i stand til å bære mediene en sang er avhengig av sammen med selve sangen på en plattformagnostisk 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 elementets identifikator, som inneholder:

• manifest.json — elementet selv, 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 inne i en bindemappe er bare den PDF-en eller MP3-en.
• Mapper for dets barn, oppkalt etter hva de er — songs, attachments — hver som inneholder 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 bindemappe som inneholder en bok med to hundre sanger har samme format som en som inneholder ett enkelt akkoider.

Inne i et manifest er referanser til barn markert med et $binder. prefiks, slik at 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 — akkoridtabellen og alt som er knyttet til den.
• Sett — sangene i deres rekkefølge, med setets egen arrangement.
• Bøker — en hel samling.
• Vedlegg — PDF-er, bilder, lyd og 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 gjengir et biblioteks innhold trofast, 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^® Bindemappe er den gjeldende. Bruk den for deling med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se inni.

Import og eksport

Bindmapper importeres som hvilken som helst annen fil: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Hvis du importerer en bindemappe som inneholder et sett, gjenopprettes settet og alle sangene i det; hvis du importerer en som inneholder en enkelt sang, legges den sangen til.

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

Bindmapper 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 befinner seg i Filer-appen er det som reiser over nettverket.

Fordi en bindemappe er en ZIP av vanlig JSON og vanlige mediefiler, er det det rette formatet å velge når du trenger å se hva OnSong faktisk lagret — eller når noe annet trenger å lese innholdet ditt og ikke er OnSong.