OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en låt, en uppsättning eller en hel bok mellan bibliotek. Liksom OnSong^® Archive innehåller den allt som behövs för att återskapa innehållet någon annanstans — låttexten, bifogade filer, stilar, inställningar, transponering och anteckningar — men där ett arkiv är en enda opak blob är en binder en mapp med vanliga filer. Det gör den läsbar, inspicerbar och kan bära de mediafiler 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 ett och du hittar en mapp uppkallad efter objektets identifierare, innehållande:

• manifest.json — själva objektet, serialiserat. Alla egenskaper som OnSong känner till det, i samma format som OnSong-webb-API:n använder.
• Dess fil, om den har en. En bifogad fil 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, uppkallade efter vad de är — songs, attachments — var och en innehållande fler mappar av exakt samma struktur.

Den strukturen upprepas hela vägen ner: en uppsättning innehåller låtar, en låt innehåller bifogade filer, 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 har samma format som en som innehåller ett enda nummer.

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

Vad den innehåller

• Låtar — ackordtablaturen och allt som är kopplat till den.
• Uppsättningar — låtarna i sin ordning, med uppsättningens eget arrangemang.
• Böcker — en helt samling.
• Bifogade filer — PDF-filer, bilder, ljud och andra filer kopplade till en låt. Du kan välja att endast inkludera bifogade filer som faktiskt används istället för varje version som någonsin lagts till.

Binder eller arkiv?

Båda runt-reser 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 man ska använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Binder är det aktuella. Använd det för att dela med nyare versioner av OnSong — och när du vill ha en fil som du kan öppna och titta inuti.

Importering och exportering

Binders importeras på samma sätt som alla andra filer gör: öppna en från Filer, E-post, 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 en ZIP av vanlig JSON och vanliga mediafiler är det rätt format att gripa efter 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.