OnSong^® Binder

The OnSong^® Binder bestandsformaat 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 nummertekst, bijlagen, stijlen, instellingen, transponering en aantekeningen — maar waar een archief een enkel ondoorzichtig bestand is, is een binder een map met gewone bestanden. Hierdoor is het leesbaar, inspecteerbaar en kan het media die een nummer nodig heeft samen met het nummer zelf op een platformonafhankelijke manier meevoeren.

The OnSong^® Binder bestandsformaat heeft een bestandsextensie van .onsongbinder of .binder, en een MIME-type van application/onsong-binder.

Wat zit erin

Een binder is een ZIP-archief. Pak er een uit en je vindt een map met de naam van de identificatie van het item, bevattend:

• 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 items, genoemd naar wat ze zijn — songs, attachments — elk bevattend 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 die een boek van tweehonderd nummers bevat, heeft hetzelfde formaat als een die een enkel nummer 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 die naar een map ernaast wijst.

Wat het meevoert

• Nummers — de akkoordschema's en alles wat eraan is gekoppeld.
• Sets — de nummers in hun volgorde, met de eigen arrangement van de set.
• Boeken — een volledige verzameling.
• Bijlagen — PDF's, afbeeldingen, audio en elk ander bestand dat aan een nummer is gekoppeld. U 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 Archive?

Beide doen een bibliotheekinhoud getrouw heen en weer, dus de keuze gaat erover wat u 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 de huidige. Gebruik het voor delen met nieuwere versies van OnSong — en wanneer je een bestand wilt hebben dat je kunt openen en bekijken.

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

Om er een te maken, gebruikt u Delen en kiest u OnSong Binder als format.

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

Omdat een binder een ZIP van gewone JSON en gewone mediabestanden is, is het het juiste formaat om naar te grijpen wanneer u wilt zien wat OnSong daadwerkelijk heeft opgeslagen — of wanneer iets uw inhoud moet lezen en het is niet OnSong.