OnSong^® Binder

OnSong^® Bindemappe-filformatet er hvordan OnSong flytter en sang, et sett eller en hel bok mellom biblioteker. Som OnSong^® Arkiv inneholder den alt som trengs for å gjenoppbygge innholdet et annet sted — sangteksten, vedlegg, stiler, innstillinger, transponering og merknader — men mens et arkiv er en enkelt ugjennomsiktig blob, er en bindemappe en mappe med ordinære filer. Det gjør den lesbar, inspiserbar og i stand til å bære media som en sang er avhengig av sammen med sangen selv på en plattformuavhengig måte.

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

Hva som er inni

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

• manifest.json — selve elementet, serialisert. Hver egenskap OnSong kjenner til det, i samme form som OnSong web API bruker.
• Filen, 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 dens barn, oppkalt etter hva de er — songs, attachments — hver holder 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 holder en bok med to hundre sanger har samme format som en som holder ett enkelt lydark.

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 inn i en mappe ved siden av det.

Hva den bærer

• Sanger — lydarkivet og alt som er knyttet til det.
• Sett — sangene i deres rekkefølge, med settet sin egen arrangement.
• Bøker — en hel samling.
• Vedlegg — PDF-er, bilder, lyd og enhver annen fil knyttet til en sang. Du kan velge å inkludere kun vedleggene som faktisk er i bruk i stedet for hver versjon som noen gang ble lagt til.

Bindemappe eller arkiv?

Begge gjør bibliotekens innhold trofast om igjen, så valget handler om hva du trenger fra filen:

• OnSong^® Arkiv er det eldre formatet, og er det du bør bruke for kompatibilitet med tidligere versjoner av OnSong.
• OnSong^® Bindemappe er den nåværende. Bruk den til å dele med nyere versjoner av OnSong — og når du vil ha en fil du kan åpne og se inni.

Import og eksport

Bindemmapper importerer slik som enhver annen fil gjør: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Import av en bindemappe som inneholder et sett gjenskaper settet og hver sang i det; import av en som inneholder en enkelt sang legger til den sangen.

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

Bindemmapper 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 er det som reiser over nettverket.

Fordi en bindemappe er en ZIP av vanlig JSON og ordinære 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 ikke er OnSong.