OnSong^® Mappe

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

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

Hva er Inni

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

• manifest.json — elementet selv, serialisert. Alle egenskaper OnSong vet om det, i samme form som OnSong-nett-APIen bruker.
• Dens fil, hvis den har en. Et vedlegg beholder sitt opprinnelige filnavn, så en PDF eller en MP3 inni en mappe er bare den PDF-en eller MP3-en.
• Mapper for dets barn, oppkalt etter hva de er — songs, attachments — hver 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 mappe som holder en bok med to hundre sanger er samme format som en som holder et enkelt lead sheet.

Inni et manifest er referanser til barn merket med et $binder.-prefiks, slik at en leser kan se 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 — akkordarket og alt som er knyttet til det.
• Sett — sangene i deres rekkefølge, med setets egen arrangement.
• Bøker — en hele 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.

Mappe eller Arkiv?

Begge gjør et biblioteks innhold fullstendig ut og inn igjen, 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^® 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 inni.

Importering og Eksportering

Mapper importeres som alle andre filer: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Importering av en mappe 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 Binder som formatet.

Mapper er også det OnSong Connect sender mellom enheter når en enhet spør 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 mappe er en ZIP med vanlig JSON og vanlige mediefiler, er det riktig format å velge når du trenger å se hva OnSong faktisk lagret — eller når noe må lese innholdet ditt og ikke er OnSong.