OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en låt, en uppsättning eller en hel bok mellan bibliotek. Precis 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, transposition och anteckningar — men där ett arkiv är en enda tätt paketerad blob är en binder en mapp med vanliga filer. Det gör den läsbar, inspekterbar och kan bära de media som en låt är beroende av tillsammans med låten själv på ett plattformsagnostiskt sätt.

OnSong^® Binder-filformatet har ett filtillä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 uppkallad efter artikelns identifierare, innehållande:

• manifest.json — artikeln själv, serialiserad. Alla egenskaper OnSong vet om den, i samma form som OnSong-webbet-API:n 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 underordnade, uppkallade efter vad de är — songs, attachments — var och en innehåller fler mappar av exakt samma form.

Den strukturen återupprepas 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 ackordschema.

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

Vad den bär

• Låtar — ackordchemat och allt som är kopplat till det.
• Uppsättningar — låtarna i deras ordning, med uppsättningens egen arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF:er, bilder, ljud och vilken annan fil som helst som är kopplad till en låt. Du kan välja att endast inkludera bilagorna som faktiskt används snarare än varje version som någonsin lagts till.

Binder eller arkiv?

Båda återför 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 du kan öppna och titta inuti.

Importering och exportering

Binders importeras på samma sätt som vilken annan fil som helst: öppna en från Filer, E-post, 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 enda låt lägger till den låten.

Om du vill 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 det som reser ö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 lagrat — eller när något behöver läsa ditt innehål och inte är OnSong.