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 andre steder — sangteksten, vedlegg, stiler, innstillinger, transponering og merknader — men der et arkiv er en enkelt ugjennomsiktig blob, er en binder en mappe med vanlige filer. Det gjør den lesbar, inspiserbar og i stand til å bære medien en sang avhenger av sammen med sangen selv på en plattformágnostisk måte.

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

Hva er inne

En binder er et ZIP-arkiv. Pakk ut en og du vil finne en mappe oppkalt etter elementets identifikator, inneholder:

• manifest.json — elementet selv, serialisert. Hver egenskap OnSong vet om 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 binder er bare den PDF-en eller MP3-en.
• Mapper for dens underordnede elementer, oppkalt etter hva de er — songs, attachments — hver inneholder flere mapper med 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 binder som holder en bok med to hundre sanger er samme format som en som holder et enkelt diagram.

Inni et manifest markeres referanser til underordnede elementer med et $binder. prefiks, så 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 — akkorddiagrammet og alt som er vedlagt det.
• Sett — sangene i deres rekkefølge, med setets eget arrangement.
• Bøker — en hele 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 ble lagt til.

Binder eller arkiv?

Begge gjør en biblioteks innhold tro tur-retur, 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^® Binder er gjeldende. 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

Bindere importeres som alle andre filer: åpne en fra Filer, Mail, AirDrop eller en skytjeneste og velg OnSong. Importering av en binder som inneholder et sett gjenoppretter 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 format.

Bindere 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 appen Filer er det som reiser over nettverket.

Fordi en binder er en ZIP-fil med ren JSON og vanlige mediefiler, er det det riktige formatet når du trenger å se hva OnSong faktisk lagret — eller når noe trenger å lese innholdet ditt og det ikke er OnSong.