OnSong^® Binder

De OnSong^® Binder-bestandsindeling 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 nummertekst, bijlagen, stijlen, instellingen, transponering en annotaties — maar terwijl een archief een enkele ondoorzichtige blob is, is een binder een map met gewone bestanden. Dit maakt het leesbaar, inspeceerbaar en in staat om de media die een nummer nodig heeft, naast het nummer zelf op een platform-agnostische 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 identifier van het item, bevattende:

• 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 behoudt zijn originele bestandsnaam, dus een PDF of MP3 in een binder is gewoon die PDF of MP3.
• Mappen voor onderliggende items, genoemd naar wat ze zijn — songs, attachments — elk bevat 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 één die een enkel chart bevat.

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 — de akkoordenschema 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. Je kunt ervoor kiezen om alleen de bijlagen op te nemen die werkelijk worden gebruikt in plaats van elke versie die ooit is toegevoegd.

Binder of Archief?

Beide voeren de inhoud van een bibliotheek getrouw door, dus de keuze gaat erover 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 deze voor delen met nieuwere versies van OnSong — en wanneer je een bestand wilt dat je kunt openen en bekijken.

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

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

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

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