Gebruikershandleiding
OnSong® Binder
De OnSong® Binder-bestandsindeling is hoe OnSong een nummer, een set of een heel boek tussen bibliotheken verplaatst. Zoals het OnSong® Archive bevat het alles wat nodig is om de inhoud ergens anders 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. Dat maakt het leesbaar, controleerbaar en in staat om de media waarvan een nummer afhankelijk is naast het nummer zelf op een platformonafhankelijke manier mee te voeren.
De OnSong® Binder-bestandsindeling heeft een bestandsextensie van .onsongbinder of .binder en een MIME-type van application/onsong-binder.
Wat zit erin
Een binder is een ZIP-archief. Als je er een uitpakt, vind je een map met de naam van de identifier van het item, 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 één met een enkel nummer.
In een manifest worden verwijzingen naar onderliggende items gemarkeerd met het voorvoegsel $binder., zodat een lezer het verschil kan zien tussen een waarde die tot het item behoort en een die naar een map ernaast wijst.
Wat het meevoert
- Nummers — het akkoordenschema en alles wat eraan is gekoppeld.
- Sets — de nummers in hun volgorde, met de eigen arrangement van de set.
- Boeken — een hele collectie.
- 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 brengen de inhoud van een bibliotheek getrouw terug, dus de keuze gaat over wat u nodig hebt van het bestand:
- OnSong® Archive is de oudere indeling en is wat u moet gebruiken voor compatibiliteit met eerdere versies van OnSong.
- OnSong® Binder is de huidige. Gebruik het voor het delen met nieuwere versies van OnSong — en wanneer u een bestand wilt dat u kunt openen en erin kunt kijken.
Importeren en exporteren
Binders worden geïmporteerd zoals elk ander bestand: open er een vanuit Bestanden, Mail, AirDrop of een cloudservice en kies OnSong. Het importeren van een binder met een set herstelt de set en elk nummer erin; het importeren van een met een enkel nummer voegt dat nummer toe.
Gebruik Delen en kies OnSong Binder als de indeling om er een te maken.
Binders zijn ook wat OnSong Connect tussen apparaten verzendt wanneer het ene apparaat het andere om een nummer of een set vraagt, dus dezelfde indeling die in uw Bestanden-app leeft, is de indeling die via het netwerk reist.
Omdat een binder een ZIP van gewone JSON en gewone mediabestanden is, is het de juiste indeling voor wanneer u wilt zien wat OnSong daadwerkelijk heeft opgeslagen — of wanneer iets uw inhoud moet lezen en dat niet OnSong is.