OnSong^® Binder

De OnSong^® Binder-bestandsindeling is hoe OnSong een nummer, een set 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 blob is, is een binder een map met gewone bestanden. Dit maakt het leesbaar, inspecteerbaar en in staat om de media waar een nummer van afhangt naast het nummer zelf op een platformonafhankelijke manier mee te dragen.

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

Wat zit er in

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 bestand ervan, indien aanwezig. Een bijlage behoudt de oorspronkelijke bestandsnaam, dus een PDF of MP3 in een binder is gewoon die PDF of MP3.
• Mappen voor de onderliggende elementen, genoemd naar wat ze zijn — songs, attachments — elk met meer mappen van precies dezelfde vorm.

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 dezelfde indeling als een met een enkel chart.

In een manifest worden verwijzingen naar onderliggende elementen 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 bevat

• Nummers — de akkoordenlijn en alles wat eraan is gekoppeld.
• Sets — de nummers in hun volgorde, met de eigen arrangering van de set.
• Boeken — een hele verzameling.
• Bijlagen — PDF's, afbeeldingen, audio en elk ander bestand dat bij een nummer hoort. 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 voeren de inhoud van een bibliotheek getrouw terug, dus de keuze gaat erover wat je nodig hebt van het bestand:

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

Importeren en exporteren

Binders worden op dezelfde manier geïmporteerd als elk ander bestand: open er een van Bestanden, Mail, AirDrop of een cloudservice en kies OnSong. Als je een binder importeert die een set bevat, wordt de set en elk nummer erin opnieuw gemaakt; als je er een importeert die een enkel nummer bevat, wordt dat nummer toegevoegd.

Gebruik Delen en kies OnSong Binder als de indeling om er een te maken.

Binders zijn ook wat OnSong Connect tussen apparaten verstuurt wanneer het ene apparaat het andere om een nummer of een set vraagt, dus dezelfde indeling die in je Bestanden-app staat is degene die 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 moet zien wat OnSong werkelijk heeft opgeslagen — of wanneer iets je inhoud moet lezen en het is niet OnSong.