OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en sång, 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 — sångtexten, 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 det läsbart, inspekterbart och möjligt att bära med sig de medier en sång är beroende av tillsammans med själva sången 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 finns inuti

En binder är ett ZIP-arkiv. Packa upp en och du hittar en mapp med namn efter objektets identifierare, innehållande:

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

Den strukturen återupprepas hela vägen ned: en uppsättning innehåller sånger, en sång 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 sånger är samma format som en som innehåller ett enda schema.

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

Vad den bär

• Sånger — ackordschema och allt som är kopplat till det.
• Uppsättningar — sångerna i sin ordning, med uppsättningens egen arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF:er, bilder, ljud och alla andra filer associerade med en sång. Du kan välja att endast inkludera de bilagor som faktiskt används snarare än varje version som någonsin lagts till.

Binder eller arkiv?

Båda rundar in 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 den nuvarande. Använd den för delning med nyare versioner av OnSong — och när du vill ha en fil du kan öppna och titta inuti.

Importering och exportering

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. Importering av en binder som innehåller en uppsättning återskapar uppsättningen och varje sång i den; importering av en som innehåller en enda sång lägger till den sången.

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 sång eller en uppsättning, så samma format som finns i din Filer-app är den som färdas över nätverket.

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