OnSong^® Mapp

OnSong^® Binder-filformatet är hur OnSong flyttar en låt, ett set 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, bilagor, stilar, inställningar, transposition och anteckningar — men medan ett arkiv är en enda ogenomskinlig blob, är en binder en mapp med vanliga filer. Det gör den läsbar, inspekterbar och kapabel att bära de mediefiler som en låt är beroende av tillsammans med själva låten på ett plattformsagnostiskt sätt.

OnSong^® Binder-filformatet har en filnamnstillägg på antingen .onsongbinder eller .binder, och en MIME-typ av application/onsong-binder.

Vad som finns inuti

En binder är ett ZIP-arkiv. Packa upp en och du hittar en mapp som är 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-webbaserade 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 MP3.
• Mappar för dess underordnade objekt, uppkallade efter vad de är — songs, attachments — var och en innehållande fler mappar av exakt samma form.

Den strukturen upprepas hela vägen ner: ett set 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 har samma format som en som innehåller ett enskilt musiknummer.

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

Vad den innehåller

• Låtar — ackordschemat och allt som är kopplat till det.
• Set — låtarna i deras ordning, med setets egen arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF-filer, bilder, ljud och alla andra filer associerade med en låt. Du kan välja att inkludera endast de bilagor som faktiskt används i stället för alla versioner som någonsin lagts till.

Binder eller arkiv?

Båda gör en biblioteksinnehål runt trip på ett tillförlitligt sätt, så valet handlar om vad du behöver från filen:

• OnSong^® Archive är det äldre formatet, och är vad du bör använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Binder är det nuvarande. Använd det för att dela med senare 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: öppna en från Filer, Mail, AirDrop eller en molntjänst och välj OnSong. Importering av en binder som innehåller ett set återskapar setet och varje låt i det; importering av 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.

Binders är också vad OnSong Connect skickar mellan enheter när en enhet ber en annan om en låt eller ett set, så samma format som bor i din Filer-app är den 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 annat behöver läsa ditt innehål och inte är OnSong.