OnSong^® Binder

Het OnSong^® Binder-bestandsformaat is hoe OnSong een nummer, een verzameling of een heel boek tussen bibliotheken verplaatst. Net als het OnSong^® Archive bevat het alles wat nodig is om de inhoud ergens anders opnieuw op te bouwen — de songtekst, bijlagen, stijlen, instellingen, transponering en annotaties — maar waar een archief een enkel ondoorzichtig bestand is, is een binder een map met gewone bestanden. Dat maakt het leesbaar, inspecteerbaar en in staat om de media waar een nummer van afhankelijk is op een platformonafhankelijke manier naast het nummer zelf mee te nemen.

Het OnSong^® Binder-bestandsformaat heeft een bestandsextensie van .onsongbinder of .binder en een MIME-type van application/onsong-binder.

Wat erin zit

Een binder is een ZIP-archief. Pak er een uit en je vindt een map met de naam van de identifier van het item, met daarin:

• manifest.json — het item zelf, geserialiseerd. Elke eigenschap die OnSong ervan kent, in dezelfde vorm die de OnSong web-API gebruikt.
• Het bijbehorende bestand, als het er een heeft. Een bijlage behoud zijn originele bestandsnaam, dus een PDF of MP3 in een binder is gewoon die PDF of MP3.
• Mappen voor de onderliggende items, vernoemd naar wat ze zijn — songs, attachments — elk met meer mappen van exact dezelfde structuur.

Die structuur herhaalt zich helemaal naar beneden: een verzameling bevat nummers, een nummer bevat bijlagen, en elk is een map met zijn eigen manifest naast zijn eigen bestanden. Een binder met een boek van tweehonderd nummers heeft dezelfde indeling als een met een enkel akkoordenblad.

Binnen een manifest worden verwijzingen naar onderliggende items gemarkeerd met een $binder. voorvoegsel, zodat een lezer het verschil kan zien tussen een waarde die bij het item hoort en een waarde die naar een map ernaast wijst.

Wat het meeneemt

• Nummers — het akkoordenblad en alles wat eraan is bevestigd.
• Verzamelingen — de nummers in hun volgorde, met de eigen arrangement van de verzameling.
• Boeken — een hele collectie.
• Bijlagen — PDF's, afbeeldingen, audio en elk ander bestand dat aan een nummer is gekoppeld. Je kunt ervoor kiezen om alleen de bijlagen op te nemen die daadwerkelijk worden gebruikt in plaats van elke versie die ooit is toegevoegd.

Binder of Archive?

Beide geven de inhoud van een bibliotheek op betrouwbare wijze terug, dus de keuze gaat erover wat je van het bestand nodig hebt:

• OnSong^® Archive is het oudere formaat en is wat je moet gebruiken voor compatibiliteit met eerdere versies van OnSong.
• OnSong^® Binder is de huidige versie. Gebruik het voor delen met nieuwere versies van OnSong — en wanneer je een bestand wilt dat je kunt openen en inspecteren.

Importeren en exporteren

Binders importeren op dezelfde manier als elk ander bestand: open er een van Bestanden, Mail, AirDrop of een cloudservice en kies OnSong. Een binder importeren die een verzameling bevat, recreëert de verzameling en elk nummer erin; een binder importeren die een enkel nummer bevat, voegt dat nummer toe.

Om er een te maken, gebruik je Delen en kies OnSong Binder als het formaat.

Binders zijn ook wat OnSong Connect tussen apparaten verzendt wanneer het ene apparaat het andere om een nummer of verzameling vraagt, dus hetzelfde formaat dat in je Bestanden-app zit, is het formaat dat over het netwerk reist.

Omdat een binder een ZIP van gewone JSON en gewone mediabestanden is, is het het juiste formaat om voor in te grijpen wanneer je wilt zien wat OnSong daadwerkelijk heeft opgeslagen — of wanneer iets je inhoud wil lezen en het niet OnSong is.