OnSong^® Bindmapje

De OnSong^® Binder-bestandsindeling is hoe OnSong een nummer, een set of een volledig boek tussen bibliotheken verplaatst. Net als het OnSong^® Archief 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 blok is, is een binder een map met gewone bestanden. Dit maakt het leesbaar, inspecteerbaar en geschikt om de media waar een nummer van afhangt naast het nummer zelf op een platform-onafhankelijke manier mee te voeren.

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 item-id, 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, als het er een heeft. Een bijlage behoudt de oorspronkelijke bestandsnaam, dus een PDF of MP3 in een binder is gewoon die PDF of MP3.
• Mappen voor de onderliggende items, genoemd naar wat ze zijn — songs, attachments — elk met meer mappen van exact dezelfde vorm.

Die structuur herhaalt zich helemaal: 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 binder met een enkel akkoordschema.

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 bevat

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

Binder of archief?

Beide transporteren de inhoud van een bibliotheek op trouwe wijze, dus de keuze gaat om wat je van het bestand nodig hebt:

• OnSong^® Archief 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 u een bestand wilt hebben dat u kunt openen en inspectie.

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, zet de set en elk nummer erin opnieuw op; een binder met een enkel nummer importeren voegt dat nummer toe.

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

Binders zijn ook wat OnSong Connect tussen apparaten verzendt wanneer het ene apparaat het ander om een nummer of een set vraagt, dus dezelfde indeling die in uw Bestanden-app staat, is ook degene die over het netwerk reist.

Omdat een binder een ZIP van gewoon JSON en gewone mediabestanden is, is het de juiste indeling wanneer je wilt zien wat OnSong daadwerkelijk heeft opgeslagen — of wanneer iets je inhoud moet lezen en dit niet OnSong is.