OnSong^® Binder

OnSong^® Bindfilformatet ä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 kommentarer — men medan ett arkiv är en enda opak blob, är en binder en mapp med vanliga filer. Det gör den läsbar, inspekterbar och kan bära media som en låt är beroende av tillsammans med låten själv på ett plattformsagnostiskt sätt.

OnSong^® Bindfilformatet har en filtillä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 som är namngiven efter objektets identifierare, innehållande:

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

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 binder som innehåller en bok med tvåhundra låtar är 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 — ackordschema och allt som är kopplat till det.
• Uppsättningar — låtarna 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 låt. Du kan välja att endast inkludera bilagorna som faktiskt används istället för varje version som någonsin lagts till.

Binder eller arkiv?

Båda gör en biblioteks innehål runt på ett troget sätt, så valet handlar om vad du behöver från filen:

• OnSong^® Archive är det äldre formatet, och är vad man ska använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Binder är den nuvarande. Använd det 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 vilken annan fil som helst: ö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 låt i den; importering 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 reser över nätverket.

Eftersom en binder är ett ZIP av vanlig JSON och vanliga mediafiler, ä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 inte är OnSong.