XBUP - Dokumentace: Lidská rozhraní

Mezi hlavní rozhraní pro zpřístupnění dokumentů lidem patří především jednotné vizuální zobrazování obsahu ve formě vhodné pro porozumění člověkem.

Podobně jako je používán textový editor jako standartizovaný překladač čísel (textu v kódu ASCII) na grafické symboly, by měla být definována vhodná rozhraní i pro zpřístupnění binární struktury protokolu XBUP.

Jedním z možných zobrazení je vypsání dokumentu v textovém tvaru s využitím vhodné textové gramatiky. Pro výpis stromové struktury je možné například použít XML syntaxi, či jinou obdobu. Nejvhodnější se jeví umožnit více možných syntaxí, nebo zvolit jedinou. Vhodnost textové syntaxe je však dosti subjektivní záležitost, proto bude spíše vhodné zvolit preferovanou syntaxi, ale umožnit i použití dalších alternativ.

Lze umožnit uživatelům vytvářet nový dokument z textového tvaru. V takovém případě je však nutné zvážit, jakým způsobem bude zpracováván chybný vstup a rozpoznáno napojování odlišných specifikací na syntaxi. Z možných řešení se nabízí:

• Upozornit uživatele na chyby v syntaxi a neumožnit uložení - zřejmě ignorování chyb by mohlo vést ke ztrátě dat.
• Znemožnit napsání nevalidního dokumentu - omezit psaní textu tak, aby byl vždy automaticky doplnitelný na platný tvar.
• Upozornit uživatele na chyby a uložit dokument včetně nesprávných částí pomocí speciálních bloků.

Je v zájmu projektu nabídnout i textové rozhraní pro přístup k službám, stejně jako textový překlad komunikace. Ten by měl probíhat automatizovaně podle definovaných pravidel a gramatik.

Virtuální konzole umožňuje procházet obsah souboru, jako by jednotlivé úrovně stromu byly součástí systému souboru. Dále by mělo být možné provádět některé základní operace, jako je přidávání uzlu, odebrání, editace a podobně.

Základní varianta překládá textové příkazy na straně klienta tak, aby byla přes komunikační rozhraní přenášena data v protokolu XBUP. Ke komunikaci je definováno rozhraní protokolu XBUP pro příjem vzdálených volání.

Druhá z možných vyriant, vhodná především pro implementaci kompatibility a propojení s existujícími službami, překládá příkazy z textové konzoly přímo na straně serveru. To znamená, že příkazy jsou přenášeny přes síťovou vrstvu v textovém tvaru, například i s použitím stávajích technologií.

Jedním z příkladů textové reprezentace je textový tvar značkovacího jazyka XML.

Úroveň nula je možné reprezentovat například následujícím způsobem:

<xbup bytesize="7" version="0" signature="1">
  <node terminated="true/false" /> // Kořenový uzel
    <attribute>x</attribute>
    ...
    <attribute>x</attribute>
    <node> // Poduzel
      <attribute>0</attribute>
    </node>
    <data>XASfdsfASD/*asd</data> // Data v kódování BASE64
  </node>
</xbup>

Pořadí v jakém jsou bloky a atributy uváděny odpovídá výskytu v dokumentu. Text tagu atribut je nezáporné celé číslo. Každý uzel musí mít alespoň jeden atribut.

Úroveň 1 přidává tagu "node" XML atributy group a block, jejichž hodnoty jsou textové názvy odpovídajících specifikací XBUP dokumentu.

Kromě toho na začátku je tagu xbup přidána následující reprezentace specifikace dokumentu:

<specification>
  <group name="jméno">
    <block name="jméno"/>
    ...
    <block name="jméno"/>
  </group>
  ...
  <group name="jméno">
    <block name="jméno"/>
    ...
    <block name="jméno"/>
  </group>
</specification>

Úroveň 2 pak tagu "attribute" přidává XML atributy name a type, pro něž se v části specifikace objeví tagy <attrib type="typ" name="jméno"/> jako podtagy tagů "block".

Za předpokladu, že dva atributy nebudou mít stejné jméno, je možné použít následující XML syntaxi:

<!xbup bytesize="7" version="0" signature="1">
<název_skupiny:název_bloku id="index" term="true/false" název_atributu="hodnota" ... >
  <podblok .../>
  ...
  <data>Base64 nebo hexadecimálně kódované data</data>
  <podblok .../>
</název_skupiny:název_bloku>

Případně by také bylo možné pro bloky zavést speciální hodnoty pro toto textové vyjádření.