OnSong^® Mapp

OnSong^® Binderfilformatet är hur OnSong flyttar en låt, en uppsättning eller en hel bok mellan bibliotek. Liksom OnSong^® Archive innehåller det allt som behövs för att återskapa innehållet någon annanstans — låttexten, bilagor, stilar, inställningar, transponering och anteckningar — men där ett arkiv är en enda ogenomskinlig blob är en binder en mapp med vanliga filer. Det gör den läsbar, granskbar och i stånd att bära det media en låt är beroende av tillsammans med själva låten på ett plattformsagnostiskt sätt.

OnSong^® Binderfilformatet har ett filnamnstillägg på antingen .onsongbinder eller .binder och en MIME-typ på application/onsong-binder.

Vad som finns inuti

En binder är ett ZIP-arkiv. Zippa upp ett och du hittar en mapp som är namngiven efter objektets identifierare, innehållande:

• manifest.json — själva objektet, serialiserat. Varje egenskap som OnSong vet om det, i samma format som OnSong web API använder.
• Dess fil, om den har en. En bilaga behåller sitt ursprungliga filnamn, så en PDF eller en MP3 inuti en binder är bara just den PDF:en eller MP3:n.
• Mappar för dess underordnade, namngivna efter vad de är — songs, attachments — var och en innehållande fler mappar med exakt samma struktur.

Denna struktur upprepas hela vägen ner: en uppsättning innehåller låtar, en låt innehåller bilagor, och varje är en mapp med sitt eget manifest vid sidan om dess egna filer. En binder som innehåller en bok med två hundra låtar har samma format som en som innehåller ett enskilt notblad.

Inuti ett manifest markeras referenser till underordnade med ett $binder.-prefix, så en läsare kan skilja mellan ett värde som tillhör objektet och ett som pekar in i en mapp bredvid det.

Vad den bär

• Låtar — ackordschemat och allt som är kopplat till det.
• Uppsättningar — låtarna i deras ordning, med uppsättningens egen arrangemang.
• Böcker — en hela samling.
• Bilagor — PDF:er, bilder, ljud och alla andra filer associerade med en låt. Du kan välja att endast inkludera de bilagor som faktiskt är i bruk i stället för varje version som någonsin lagts till.

Binder eller arkiv?

Båda återskapar ett biblioteks innehål troget, så valet handlar om vad du behöver från filen:

• OnSong^® Archive är det äldre formatet, och är vad du ska använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Binder är det nuvarande. Använd det för delning med nyare versioner av OnSong — och när du vill ha en fil som du kan öppna och titta inuti.

Importera och exportera

Binders importeras på samma sätt som andra filer: öppna en från Filer, Mail, AirDrop eller en molntjänst och välj OnSong. Import av en binder som innehåller en uppsättning återskapar uppsättningen och varje låt i den; import av en som innehåller en enskild låt lägger till den låten.

För att skapa en, använd Dela och välj OnSong Binder som format.

Binders är också vad OnSong Connect skickar mellan enheter när en enhet frågar en annan om en låt eller en uppsättning, så samma format som finns i din Filer-app är det som färdas över nätverket.

Eftersom en binder är en ZIP av vanlig JSON och vanliga mediefiler är det rätt format att gripa till när du behöver se vad OnSong faktiskt lagrade — eller när något behöver läsa ditt innehål och det inte är OnSong.