OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en låt, en uppsättning eller en hel bok mellan bibliotek. Som 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 medan ett arkiv är en enda ogenomskinlig blob är en binder en mapp med vanliga filer. Det gör den läsbar, granskningsbar och kan bära den media en låt är beroende av tillsammans med själva låten på ett plattformsagnostiskt sätt.

OnSong^® Binder-filformatet 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. Packa upp en och du hittar en mapp som är namngiven efter objektets identifierare, innehållande:

• manifest.json — objektet själv, serialiserat. Alla egenskaper som OnSong känner till det, i samma form som OnSong-webbapiets 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 den PDF-filen eller MP3-filen.
• Mappar för dess underordnade objekt, namngivna efter vad de är — songs, attachments — var och en innehållande fler mappar av exakt samma form.

Denna struktur upprepas hela vägen ner: en uppsättning innehåller låtar, en låt innehåller bilagor, och var och en är en mapp med sitt eget manifest bredvid sina egna filer. En binder som innehåller en bok med två hundra låtar är samma format som en som innehåller ett enskilt ackordschema.

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

Vad den bär

• Låtar — ackordchemat och allt som är kopplat till det.
• Uppsättningar — låtarna i deras ordning, med uppsättningens eget arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF-filer, bilder, ljud och andra filer associerade med en låt. Du kan välja att endast inkludera de bilagor som faktiskt används istället för alla versioner som någonsin lagts till.

Binder eller arkiv?

Båda gör en rundan av ett biblioteks innehåll troget, så valet handlar om vad du behöver från filen:

• OnSong^® Archive är det äldre formatet, och är vad du använder för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Binder är den aktuella. Använd den för att dela med nyare versioner av OnSong — och när du vill ha en fil du kan öppna och titta inuti.

Importera och exportera

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

För att skapa en använder du Dela och väljer OnSong Binder som format.

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

Eftersom en binder är en ZIP av vanlig JSON och vanliga mediafiler, är det rätt format att välja när du behöver se vad OnSong faktiskt sparade — eller när något behöver läsa ditt innehåll och det inte är OnSong.