%\documentclass[11pt,twoside,a4paper]{mr} % two-page printing
\usepackage{graphicx}

\begin{document}

\textbf{Databáze benchmarků - uživatelská příručka}

\chapter{Základní vzhled aplikace}

Stránka webového rozhraní databáze benchmarků je rozdělena do dvou sloupců.
Vlevo se nachází hlavní nabídka aplikace, vpravo jsou umístěny datové prvky:

\includegraphics{design.png}

Vlevo nahoře se nachází logo databáze benchmarků, po kliknutí na něj se lze
dostat na titulní stranu, odkud vede odkaz na uživatelskou příručku.

\chapter{Přihlášení, odhlášení, změna hesla}

Pokud administrátor provede benevolentní nastavení, je možné základní
úkony provádět i bez přihlášení. V opačném případě je nutné se přihlašovat vždy.
Po ukončení práce je vždy vhodné se přihlásit. Pokud se uživatel neodhlásí sám,
po nějaké době je odhlášen automaticky a musí se přihlásit znovu.

Pokud chce ale uživatel provádět editaci databáze nebo administraci uživatelů,
musí se přihlásit. Samozřejmě, ne všichni uživatelé mají práva k těmto operacím.

\section{Přihlášení}

Přihlášení probíhá vložením uživatelského jména a hesla.

\includegraphics{login.png}

\section{Odhlášení}

Odhlášení přihlášeného uživatele proběhne kliknutím na odkaz \textit{Log out}.

\section{Změna hesla}

Pokud má uživatel k tomu oprávnění, může změnit svoje vlastní heslo. Přes odkaz
\textit{Password change} se dostane ke stránce zobrazené na obrázku:

\includegraphics{password.png}

Pro úspěšnou změnu hesla je třeba zadat aktuální heslo a dvakrát stejně nové heslo.

\chapter{Zobrazování informací}

V některých stránkách pro zobrazení informací jsou vloženy i ovládací prvky
vedoucí k editaci dat - vložené obrázky je pro ilustraci vždy obsahují. V
dalším textu na ně upozorním.

\section{Informace o sadách benchmarků}

Zobrazení seznamu sad se provede kliknutím na odkaz \textit{Benchmark sets listing}.

\includegraphics{sets.png}

Kliknutí na název sady vede k zobrazení jejího obsahu, Odkaz \textit{Search instances}
vede k vyhledání instancí benchmarků ze sady. Případný odkaz \textit{Edit} vede k editaci.

Zobrazené informace vypadají následovně, povšimneme si klikatelných odkazů na obsažené
formáty:

\includegraphics{setview.png}

\section{Informace o formátech}

Seznam formátů umožňuje kliknout na prohlížení, resp. editaci formátu:

\includegraphics{formats.png}

Zobrazení formátu obsahuje základní informace, podporované atributy a odkazy na sady,
které formát obsahují:

\includegraphics{formatview.png}

\section{Vyhledání instancí benchmarků}

Vyhledávání benchmarků je možné podle různých kritérií, buďto podle kritérií
pevných (podřetězec názvu, sada, formát) nebo i podle hodnot jednoho nebo více
atributů. Následující obrázek ukazuje vyhledání instancí benchmarků jejichž název obsahuje
b01, jsou formátu BENCH, nacházejí se v sadě ITC99 a obsahují více než 3 invertory.

\includegraphics{benchmarksearch.png}

Jak vidíme, benchmarky lze prohlížet, editovat, stahovat jednotlivě - odkaz \textit{Download}
v každém řádku, mazat (odkaz Delete) a stáhnout archiv všech vyhovujících benchmarků (tlačítko
Download nad tabulkou výsledků). Tlačítko \textit{Search} slouží k novému vyhledávání podle
aktuálně zadaných vyhledávacích kritérií.

Pokud je výsledků vyhledávání příliš mnoho, zobrazí se jenom část výsledků a lze se pohybovat
po jednotlivých stránkách:

\includegraphics{paging.png}

Obrázek ukazuje mimo jiné ovládací prvky nad tabulkou, které umožňují jednoduchý pohyb po
stránkách pomocí odkazů \textit{Previous} a \textit{Next}, mezi nimiž jsou informace o
číslech aktuálně zobrazených výsledků a počtu všech výsledků vyhledávání.

\section{Zobrazení informací o instanci benchmarku}

Informace o instanci benchmarku získáme kliknutím na název benchmarku ve vyhledaných výsledcích.

\includegraphics{instance.png}

\chapter{Stahování benchmarků}

Pokud byl při vkládání benchmarku zadán soubor benchmarku, je možné jej následně stáhnout.

\section{Stažení jednotlivého benchmarku}

Stažení jednotlivého benchmarku se provede kliknutím na odkaz \textit{Download} v jednotlivém
řádku tabulky výsledků vyhledávání.

\section{Agregované stahování benchmarků}

Agregované stahování se provede kliknutím na tlačítko \textit{Download} nad tabulkou výsledků
vyhledávání. Archiv benchmarků se připravuje na pozadí a stránka se překresluje s 
informativním nápisem, dokud archiv není připraven:

\includegraphics{waiting.png}

Kliknutí na odkaz \textit{Return to the main page} vrátí uživatele na hlavní stránku.

\chapter{Přidávání informací}

\section{Přidání nové instance benchmarku}

Přidání instance benchmarku probíhá ve dvou krocích. V prvním kroku se zadá formát,
sada a název benchmarku:

\includegraphics{firststep.png}

Po stisknutí tlačítka přejdeme ke druhému kroku:

\includegraphics{secondstep.png}

Povšimněme si kolonek \textit{File} a \textit{Read attribute values from file},
ty zajistí uložení souboru na server a načtení atributů pomocí analyzátoru, takže
není nutno hodnoty zadávat. Jak vidíme, obecný popis benchmarku nelze vyplnit,
protože již existuje jiná instance benchmarku se stejným jménem a popis byl vyplněn. 
Pokud budeme chtít tento obecný popis změnit, uděláme to při editaci některé instance.

\section{Přidání nové benchmarkové sady}

Přidání sady je možné přechodem ze seznamu sad benchmarků zmáčknutím tlačítka
\textit{New set}. Zadáme pouze název a popis a zmáčkneme \textit{OK}.

\includegraphics{newset.png}

\chapter{Provádění změn v databázi benchmarků}

\section{Editace formátu}

Editace formátu, dostupná z výpisu formátů, umožňuje zadat popis formátu a
určit, které atributy mají pro formát smysl a uživatel je tedy bude moci
editovat:

\includegraphics{formatedit.png}

\section{Editace sady}

Editace sady, dostupná z výpisu benchmarkových sad, umožňuje změnit název sady a
popis sady:

\includegraphics{setedit.png}

\section{Editace instance}

Editace instance je dostupná ze stránky pro vyhledání instancí benchmarků a
umožňuje měnit obecný popis benchmarku, popis instance a hodnoty jednotlivých atributů
(nebo přidat atribut, pokud je políčko prázdné nebo zrušit hodnotu smazáním obsahu políčka).

Zadáním hodnoty \textit{New name} můžeme přesunout instanci k jinému existujícímu benchmarku
(pokud se např. uklepneme) nebo vytvořit zcela nový benchmark, k němuž se instance přepojí.

Výběrem hodnoty \textit{Move to set} přesuneme instanci do jiné existující sady benchmarků.

\includegraphics{instanceedit.png}

\section{Smazání instance}

Smazání instance se provede kliknutím na odkaz \textit{Delete} ve výsledcích vyhledávání
benchmarků. Tato akce se provede okamžitě, bez potvrzování, stojí možná za zvážení, zda
nevsunout potvrzovací stránku před samotnou akci.

\chapter{Správa uživatelů}

\section{Výpis uživatelů}

Vypsání uživatelů se provede po kliknutí na položku \textit{Users listing} v hlavní nabídce.
Jak uvidíme na obrázku, u jednoho z uživatelů nejsou zobrazeny kontrolní prvky \textit{Edit}
a \textit{Delete}. Je tomu tak proto, aby si správce uživatelů omylem neomezil práva a
neznemožnil možnost správy přes webové rozhraní.

\section{Smazání uživatelského účtu}

Smazání uživatelského účtu se provede pouhým stisknutím tlačítka \textit{Delete} v příslušném
řádku.

\section{Editace uživatelského účtu}

Lze zadat nové heslo a změnit oprávnění uživatele:

\includegraphics{useredit.png}

\section{Vytvoření nového uživatelského účtu}

Vytvoření nového uživatelského účtu je triviální:

\includegraphics{usernew.png}

\chapter{Doplněk: používání řádkových programů}

\section{Použití řádkového analyzátoru (parseru)}

Použití řádkového analyzátoru je snadné, skript se jmenuje ParseInfo.py,
základní syntaxe je:

\begin{verbatim}
./ParseInfo soubor soubor soubor
\end{verbatim}

Formáty souborů jsou rozpoznávány podle přípony, v případě potřeby je možné
zadat formát explicitně:

\begin{verbatim}
./ParseInfo -t format soubor
\end{verbatim}

Více informací lze získat spuštěním skriptu s parametrem - {}-help.

\section{Dávkové plnění databáze}

Dávkové plnění databáze je popsáno v instalační příručce. Jenom v krátkosti:
provádí se skriptem BenchmarkFiller.py a jeho podrobné parametry lze získat
zadáním 

\begin{verbatim}
./BenchmarkFiller.py --help.
\end{verbatim}

\end{document}

% vim:enc=iso8859-2:fenc=iso8859-2:syntax=tex:
