OnSong^® Mappa

Az OnSong^® Binder fájlformátum az, ahogyan az OnSong egy dalt, egy setlistát vagy egy teljes könyvet mozgat a könyvtárak között. Mint az OnSong^® Archive, az is tartalmazza a tartalom máshol történő újraépítéséhez szükséges mindent — a dalszöveget, mellékleteket, stílusokat, beállításokat, transzpozíciókat és megjegyzéseket — de míg az archívum egy egyetlen átlátszatlan blob, a binder egy mappa közönséges fájlokkal. Ez teszi olvashatóvá, vizsgálhatóvá, és képessé arra, hogy a dal függőségeit a dalok mellett szállítsa platformfüggetlen módon.

Az OnSong^® Binder fájlformátum fájlkiterjesztése .onsongbinder vagy .binder, és MIME-típusa application/onsong-binder.

Mi van benne

A binder egy ZIP-archívum. Ha kicsomagol egyet, talál egy mappát az elem azonosítója alapján elnevezve, amely tartalmazza:

• manifest.json — maga az elem, sorosítva. Minden tulajdonság, amelyről az OnSong tud, ugyanabban az alakban, amit az OnSong web API használ.
• Az ő fájlja, ha van neki. A melléklet megtartja az eredeti fájlnevet, így egy PDF vagy MP3 a binder-ben csak az a PDF vagy MP3.
• Mappák a gyermekeihez, elnevezve azzal, hogy mik — songs, attachments — mindegyik több mappát tartalmaz, pontosan ugyanabban az alakban.

Ez a szerkezet ismétlődik egészen le: egy setlist dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifesttal a saját fájljai mellett. Egy kétszáz dalt tartalmazó könyvet tartó binder ugyanaz a formátum, mint egy egyetlen chart-ot tartó binder.

A manifest-ben a gyermekekre való hivatkozások egy $binder. előtaggal vannak jelölve, így az olvasó meg tudja különböztetni az elem tulajdonát képviselő értéket a mellette lévő mappára mutató értéktől.

Mit szállít

• Dalok — az akkordtábla és minden, ami hozzá kapcsolódik.
• Setlisták — a dalok sorrendjükben, a setlist saját megrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és bármilyen más fájl, amely egy dalhoz tartozik. Választhat, hogy csak az aktuálisan használatban lévő mellékleteket foglalja bele, nem pedig minden verzióját, amely valaha is hozzáadódott.

Binder vagy Archive?

Mindkettő hűen körbekörgeti a könyvtár tartalmát, így a választás arról szól, hogy mit kell a fájlból:

• OnSong^® Archive az régebbi formátum, és ezt használja az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Binder a jelenlegi. Használja az újabb OnSong-verziókkal való megosztáshoz — és ha olyan fájlt szeretne, amelyet megnyithat és megnézhet.

Importálás és exportálás

A binder-ek ugyanúgy importálódnak, mint bármely más fájl: nyissa meg az egyik fájlt a Fájlok, E-mail, AirDrop vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Egy setlistát tartalmazó binder importálása újra létrehozza a setlistát és minden dalát; egy egyetlen dalt tartalmazó binder importálása hozzáadja azt a dalt.

Egy létrehozásához használja a Megosztás lehetőséget, és válassza a OnSong Binder formátumot.

A binder-ek az OnSong Connect által az eszközök között küldöttek, amikor egyik eszköz egy másiktól egy dalt vagy setlistát kér, így ugyanaz a formátum, amely a Fájlok appban található, az a hálózaton keresztül utazik.

Mivel a binder egy ZIP egyszerű JSON-ből és közönséges médiafájlokból, ez a helyes formátum, amikor meg kell nézni, hogy az OnSong valójában mit tárol — vagy amikor valami szükséges az Ön tartalmának olvasásához és nem az OnSong.