OnSong^® Binder

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

Het bestandsformaat OnSong^® Binder 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 weet, in dezelfde vorm die de OnSong web API gebruikt.
• Het bestand ervan, indien aanwezig. Een bijlage behoudt zijn oorspronkelijke bestandsnaam, dus een PDF of MP3 in een binder is gewoon die PDF of MP3.
• Mappen voor onderliggende items, genoemd naar wat zij zijn — songs, attachments — elk bevat meer mappen met exact dezelfde structuur.

Die structuur herhaalt zich helemaal naar beneden: een set 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 hetzelfde formaat als een binder met één chart.

In 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 draagt

• Nummers — de akkoordschema en alles wat eraan vastzit.
• Sets — de nummers in hun volgorde, met de eigen arrangement van de set.
• 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 werkelijk in gebruik zijn in plaats van elke versie die ooit is toegevoegd.

Binder of Archief?

Beide brengen de inhoud van een bibliotheek getrouw heen en weer, dus de keuze gaat erom wat je van het bestand nodig hebt:

• OnSong^® Archief is het oudere formaat en is wat je moet gebruiken voor compatibiliteit met eerdere versies van OnSong.
• OnSong^® Binder is het huidige. Gebruik het voor delen met nieuwere versies van OnSong — en als je een bestand wilt waarmee je kunt openen en erin kunt kijken.

Importeren en Exporteren

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

Gebruik Delen en kies OnSong Binder als het formaat om er een te maken.

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

Omdat een binder een ZIP van gewone JSON en normale mediabestanden is, is het het juiste formaat om naar te grijpen wanneer je wilt zien wat OnSong werkelijk heeft opgeslagen — of wanneer iets je inhoud moet lezen en dat niet OnSong is.