OnSong^® Pořadač

Formát souboru OnSong^® Binder je způsob, jak OnSong přesunuje píseň, sadu nebo celou knížku mezi knihovnami. Podobně jako OnSong^® Archive obsahuje vše potřebné k obnovení obsahu jinde — text písně, přílohy, styly, nastavení, transponování 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, inspekcionovatelným a schopným přenášet média, na která je píseň závislá, vedle samotné písně způsobem nezávislým na platformě.

Formát souboru OnSong^® Binder má příponu souboru .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ě, kterou používá OnSong web API.
• Její soubor, pokud nějaký má. Příloha si ponechává svůj původní název, takže PDF nebo MP3 uvnitř binderu je prostě ten PDF nebo MP3.
• Složky pro její potomky, pojmenované podle toho, co jsou — songs, attachments — každá obsahující více složek přesně stejné struktury.

Tato struktura se opakuje až dolů: sada obsahuje písně, píseň obsahuje přílohy a každá je složka se svým vlastním manifestem vedle svých vlastních souborů. Binder obsahující knížku dvou set písní má stejný formát jako ten obsahující jeden notový list.

Uvnitř manifestu jsou odkazy na potomky označeny předponou $binder., takže čtenář může rozlišit mezi hodnotou, která patří položce, a hodnotou, která ukazuje do sousední složky.

Co nese

• Písně — akordový notový list a vše, co je k němu připojeno.
• Sady — písně v jejich pořadí se svým vlastním uspořádáním sady.
• Knížky — celou sbírku.
• Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor přidružený k písni. Můžete si vybrat, zda chcete zahrnout pouze přílohy, které se skutečně používají, místo každé verze, která byla někdy přidána.

Binder nebo archiv?

Oba věrně a obousměrně přenášejí obsah knihovny, takže volba spočívá v tom, co od souboru potřebujete:

• OnSong^® Archive je starší formát a je to, co použít pro kompatibilitu s dřívější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 prohlédnout si jej.

Import a export

Bindery se importují jako kterýkoli jiný soubor: otevřete jeden ze souborů, pošty, AirDrop nebo cloudové služby a zvolte OnSong. Import binderu, který obsahuje sadu, znovu vytvoří sadu a každou píseň v ní; import binderu s jedinou písní tuto píseň přidá.

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

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

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