OnSong^® Binder

The OnSong^® Binder bestandsformaat 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 aantekeningen — maar waar een archief een enkel ondoorzichtig bestand is, is een binder een map met normale bestanden. Dit maakt het leesbaar, inspecteerbaar en in staat om de media waarvan een nummer afhankelijk is, naast het nummer zelf op een platform-onafhankelijke manier mee te voeren.

Het OnSong^® Binder bestandsformaat 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 die naar de identificatie van het item is genoemd, bevattende:

• 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 originele 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 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 dezelfde indeling als een binder met een enkel accoord-schema.

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 een waarde die naar een map ernaast wijst.

Wat het bevat

• Nummers — het accoord-schema en alles wat eraan is gekoppeld.
• Sets — de nummers in hun volgorde, met de eigen rangschikking 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 daadwerkelijk in gebruik zijn, in plaats van elke versie die ooit is toegevoegd.

Binder of Archief?

Beide brengen de inhoud van een bibliotheek betrouwbaar heen en terug, 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 formaat. Gebruik het voor delen met nieuwere versies van OnSong — en wanneer je een bestand wilt dat je kunt openen en inspecteren.

Importeren en exporteren

Binders importeren op dezelfde manier als elk ander bestand: open er een uit Bestanden, Mail, AirDrop of een cloudservice en kies OnSong. Het importeren van een binder met een set maakt de set en elk nummer erin opnieuw aan; het importeren van een binder met een enkel nummer voegt dat nummer toe.

Om er een te maken, gebruik je Delen en kies je OnSong Binder als het formaat.

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

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