OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en sång, 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 — sångtexten, bilagor, stilar, inställningar, transponering och anteckningar — men medan ett arkiv är en enda ogenomskinlig blob är en mapp en folder med vanliga filer. Det gör den läsbar, inspekterbar och kan bära det media en sång är beroende av tillsammans med själva sången på ett plattformsoberoende 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 mapp är ett ZIP-arkiv. Packa upp en och du hittar en folder uppkallad efter objektets identifierare, innehållande:

• manifest.json — själva objektet, 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 mapp är bara den PDF:en eller MP3:an.
• Mappar för dess underordnade, uppkallade efter vad de är — songs, attachments — var och en innehållande fler mappar med exakt samma form.

Denna struktur upprepas hela vägen ned: en uppsättning innehåller sånger, en sång innehåller bilagor, och varje är en mapp med sitt eget manifest bredvid sina egna filer. En mapp som innehåller en bok med tvåhundra sånger har samma format som en som innehåller ett enskilt musiknummer.

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

Vad den bär

• Sånger — ackorddiagrammet 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 andra filer associerade med en sång. Du kan välja att endast inkludera bilagorna som faktiskt används snarare än varje version som någonsin lagts till.

Mapp eller arkiv?

Båda gör en lokal kopia av ett biblioteks innehåll 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 använder 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 som du kan öppna och titta inuti.

Importering och exportering

Mappar importeras på samma sätt som andra filer: öppna en från Filer, Mail, AirDrop eller en molntjänst och välj OnSong. Importering av en mapp som innehåller en uppsättning återskapar uppsättningen och varje sång i den; importering av en som innehåller en enskild sång lägger till den sången.

För att skapa en använder du Dela och väljer OnSong Binder som format.

Mappar är också vad OnSong Connect skickar mellan enheter när en enhet frågar en annan om en sång eller en uppsättning, så samma format som bor i din Filer-app är det som färdas över nätverket.

Eftersom en mapp ä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 sparade — eller när något behöver läsa ditt innehåll och inte är OnSong.