OnSong^® Bindare

OnSong^® Binder-filformatet är hur OnSong förflyttar en låt, ett set 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, transposition och anteckningar — men medan ett arkiv är en enda opak blob är en binder en mapp med vanliga filer. Det gör den läsbar, inspekterbara och kan bära medier som en låt beror på tillsammans med själva låten 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 som är uppkallad efter artikelns identifierare och innehåller:

• manifest.json — själva artikeln, serialiserad. Varje egenskap som OnSong vet om den, i samma form som OnSong:s 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:en eller MP3:n.
• Mappar för dess barn, uppkallade efter vad de är — songs, attachments — var och en innehåller fler mappar av exakt samma form.

Denna struktur 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 vid sidan av 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 leadsheet.

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

Vad den bär

• Låtar — ackordschemat och allt som är bifogat till det.
• Set — låtarna i sin ordning, med setets egen arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF:er, bilder, ljud och vilken annan fil som helst som är associerad med en låt. Du kan välja att endast inkludera bilagor som faktiskt används i stället för varje version som någonsin lagts till.

Binder eller arkiv?

Båda återskapar 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 bör 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 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 ett set återskapar settet 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 frågar en annan om en låt eller ett set, 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 mediefiler är det rätt format att gripa efter 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.