OnSong^® Binder

De OnSong^® Binder-bestandsindeling is hoe OnSong een nummer, een setlist of een heel boek tussen bibliotheken verplaatst. Net als het OnSong^® Archive bevat het alles wat nodig is om de inhoud elders 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. Dit maakt het leesbaar, inspecteerbaar en in staat om de media die een nummer nodig heeft naast het nummer zelf op een platformonafhankelijke manier mee te nemen.

De OnSong^® Binder-bestandsindeling 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, die het volgende bevat:

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

Die structuur herhaalt zich helemaal naar beneden: een setlist 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 binder met een enkel akkoordenschema.

In een manifest zijn 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 één die naar een map ernaast wijst.

Wat het bevat

• Nummers — het akkoordenschema en alles wat eraan is gekoppeld.
• Setlists — de nummers in hun volgorde, met de eigen arrangement van de setlist.
• Boeken — een hele verzameling.
• 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 Archive?

Beide transporteren de inhoud van een bibliotheek nauwkeurig heen en terug, dus de keuze gaat erover wat je van het bestand nodig hebt:

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

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 setlist bevat, maakt de setlist en elk nummer erin opnieuw aan; een binder importeren die een enkel nummer bevat, voegt dat nummer toe.

Om er een te maken, gebruik je Delen en selecteer je OnSong Binder als indeling.

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

Omdat een binder een ZIP van gewone JSON en gewone mediabestanden is, is het de juiste indeling om voor te kiezen wanneer je wilt zien wat OnSong werkelijk heeft opgeslagen — of wanneer iets je inhoud moet lezen en het is niet OnSong.