OnSong^® Mapp

OnSong^® Bindefilformatet ä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 återuppbygga innehållet någon annanstans — sångtexten, bilagor, stilar, inställningar, transponering och anteckningar — men där ett arkiv är en enda ogenomskinlig blob är en bindare en mapp med vanliga filer. Det gör den läsbar, inspektionsbar och kan bära den media en låt är beroende av tillsammans med själva låten på ett plattformsoberoende sätt.

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

Vad som finns inuti

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

• manifest.json — själva objektet, serialiserat. Varje egenskap som OnSong känner till, i samma form som OnSong-webben-API:et använder.
• Dess fil, om den har en. En bilaga behåller sitt ursprungliga filnamn, så en PDF eller en MP3 inuti en bindare är bara den PDF:en eller MP3:en.
• Mappar för dess underordnade, uppkallade efter vad de är — songs, attachments — var och en innehållande fler mappar med exakt samma struktur.

Den strukturen 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 bindare som innehåller en bok med två hundra låtar har samma format som en som innehåller ett enda schema.

Inuti ett manifest markeras referenser till underordnade 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

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

Bindare eller arkiv?

Båda återger 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 aktuella. Använd den för att dela med nyare versioner av OnSong — och när du vill ha en fil som du kan öppna och titta in i.

Importering och exportering

Bindare importeras på samma sätt som alla andra filer: öppna en från Filer, E-post, AirDrop eller en molntjänst och välj OnSong. Att importera en bindare som innehåller en uppsättning återskapar uppsättningen och varje låt 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.

Bindare ä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 reser över nätverket.

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