OnSong^® Bindmappe

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

OnSong^® Bindemappfilformatet har filtypen .onsongbinder eller .binder, og MIME-typen application/onsong-binder.

Hva som er inne

En bindemappe er et ZIP-arkiv. Pakk ut en og du vil finne en mappe navngitt 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 MP3 inne i en bindemappe er bare den PDF-en eller MP3-en.
• Mapper for dets barn, navngitt etter hva de er — songs, attachments — hver som inneholder flere mapper av nøyaktig samme form.

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 inneholder en bok med to hundre sanger er samme format som en som inneholder ett enkelt diagram.

Inni et manifest er referanser til barn merket med et $binder.-prefiks, slik at en leser kan fortelle forskjellen mellom en verdi som tilhører elementet og en som peker til en mappe ved siden av det.

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 enhver 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 er blitt 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 nåværende. Bruk den når du deler med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se inni.

Importering og eksportering

Bindlemapper importeres som enhver 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 å opprette en, bruk Del og velg OnSong Bindemappe som format.

Bindlemapper 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 ligger i Filer-appen din er det som reiser over nettverket.

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