OnSong^® Pořadač

Formát souboru OnSong^® Binder je způsob, jak OnSong přesouvá píseň, sadu nebo celou knihu mezi knihovnami. Stejně jako OnSong^® Archive obsahuje vše potřebné k obnovení obsahu jinde — text písně, přílohy, styly, nastavení, transpoziaci a poznámky — ale zatímco archiv je jeden neprůhledný blob, binder je složka běžných souborů. To jej činí čitelným, kontrolovatelným a schopným nést média, na která píseň závisí, vedle samotné písně v způsobem nezávislým na platformě.

Formát souboru OnSong^® Binder má příponu souboru buď .onsongbinder nebo .binder a typ MIME application/onsong-binder.

Co je uvnitř

Binder je archiv ZIP. Když jej rozbalíte, najdete složku pojmenovanou podle identifikátoru položky, obsahující:

• manifest.json — samotná položka, serializovaná. Každá vlastnost, kterou OnSong zná, ve stejné podobě, jakou používá OnSong web API.
• Její soubor, pokud existuje. Příloha si zachovává svůj původní název souboru, takže PDF nebo MP3 uvnitř binderu je právě to PDF nebo MP3.
• Složky pro její potomky, pojmenované podle toho, co jsou — songs, attachments — každá obsahující další složky přesně stejné struktury.

Tato struktura se opakuje až do konce: sada obsahuje písně, píseň obsahuje přílohy, a každá je složka s vlastním manifestem vedle vlastních souborů. Binder obsahující knihu dvou set písní má stejný formát jako jeden obsahující jeden jediný list.

Uvnitř manifestu jsou odkazy na potomky označeny předponou $binder., takže čtečka rozlišuje mezi hodnotou, která patří položce, a jednou, která odkazuje do sousední složky.

Co přenáší

• Písně — tabulatura akordů a všechno k ní připojené.
• Sady — písně v jejich pořadí s vlastním uspořádáním sady.
• Knihy — celá sbírka.
• Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor související s písní. Můžete se rozhodnout zahrnout pouze přílohy, které se skutečně používají, spíše než každou verzi, která byla někdy přidána.

Binder nebo archiv?

Oba věrně obnovují obsah knihovny, takže volba je o tom, co od souboru potřebujete:

• OnSong^® Archive je starší formát a je to, co použít pro kompatibilitu se staršími verzemi OnSong.
• OnSong^® Binder je ten aktuální. Použijte jej pro sdílení s novějšími verzemi OnSong — a když chcete soubor, který můžete otevřít a podívat se dovnitř.

Import a export

Bindery se importují stejně jako jakýkoli jiný soubor: otevřete jeden ze Souborů, Mailu, AirDrop nebo cloudové služby a zvolte OnSong. Import binderu obsahujícího sadu znovu vytvoří sadu a každou píseň v ní; import binderu obsahujícího jednu píseň přidá tu píseň.

Chcete-li jej vytvořit, použijte Sdílet a vyberte OnSong Binder jako formát.

Bindery jsou také tím, co OnSong Connect odesílá mezi zařízeními, když jedno zařízení požádá druhé o píseň nebo sadu, takže stejný formát, který žije v aplikaci Soubory, je ten cestující po síti.

Protože binder je ZIP prostého JSON a běžných mediálních souborů, je to správný formát, na který se můžete obrátit, když potřebujete vidět, co OnSong skutečně uložil — nebo když něco potřebuje přečíst váš obsah a není to OnSong.