9.3 Pøíruèka u¾ivatele

Tato kapitola popisuje hlavní zpùsoby práce s aplikací AdminAgent. Kapitoly 9.3.1 a¾ 9.3.2. a èásteènì také kapitola 9.3.3 jsou vìnovány ka¾dému, kdo chce vyu¾ívat slu¾eb systému a efektivnì vyhledávat dokumenty podle zadaných kritérií. Dal¹í kapitoly jsou urèeny pøedev¹ím administrátorovi systému a popisují vzdálenou správu systému.

9.3.1 Napojení na server

Po spu¹tìní aplikace AdminAgent standardním dávkovým souborem admin_agent.bat je nejprve nutné se napojit na server. Kliknìte na uzel stromu Connect, vyberte server na který se hodláte dotazovat. Jestli¾e se server, který hodláte pou¾ít v nabídce nevyskytuje, je mo¾né ho do ní pøidat formuláøem pod uzlem Hostbook. Pokud hodláte pouze pokládat dotazy, zatrhnìte volbu guest. Pokud chcete provádìt administrátorské zásahy do systému, musíte znát jméno a pøístupové heslo. Natrhnìte volbu admin, modify (nastavíte-li volbu read-only, systém vám nedovolí provádìt ¾ádné zmìny) a poté mù¾ete vyplnit jméno a heslo. Kliknìte na tlaèítko Connect a vyèkejte na pøipojení.

Spu¹tìní AdminAgenta s parametry

Dávkový soubor AdminAgent.bat (volaný z admin_agent.bat) obsahuje následující pøíkaz:

java -classpath classes.jar Agent.main.AdminAgent

Tento pøíkaz zpùsobí standardní spu¹tìní AdminAgenta ani¾ by se napojoval na server. Adresu serveru stanovíme pozdìji výbìrem z tzv. HostBook.

AdminAgenta lze v¹ak také spustit s parametry serveru. Poté se ihned napojí na server jako guest (tj. anonymnì, kdy je mo¾no pokládat dotazy, ale není ji¾ mo¾né provádìt administrátorskou èinnost). Potom do dávkového souboru napí¹eme pøíkaz v následujícím formátu:

java -classpath classes.jar Agent.main.AdminAgent url_serveru

(pokud jako url_serveru uvedete localhost, znamená to ¾e se server nachází na va¹em poèítaèi) Tento zpùsob spu¹tìní volíme napø. v pøípadì, ¾e chceme rychle spustit klienta a na nìjaký èasto pou¾ívaný server a okam¾itì pøistoupit k dotazování. Pou¾ije se výchozí port serveru 45455.

Úplná syntaxe je následující:

java -classpath classes.jar Agent.main.AdminAgent [<host> [<port>]]

9.3.2 Dotazování a práce s výsledky

Vytváøet dotazy je velmi snadné. Uzel New Query Specification obsahuje hrubé informace o skladbì dotazu, z nìj se dotaz spou¹tí. Poduzly (a jim odpovídající formuláøe) uzlu New Query Specification odpovídají jednotlivým komponentám dotazu a právì na tìchto formuláøích se dotazy specifikují. Bìhem dotazování se struktura stromu mìní a to tak, ¾e do uzlu History pøibývají poduzly reprezentující jednotlivé dotazy. Uzel Last Query obsahuje v¾dy poslední polo¾ený dotaz a jeho výsledky vrácené serverem. Specifikace ji¾ polo¾ených dotazù je mo¾no znovu pøenést do specifikace nového dotazu, stejnì tak dokumenty získané libovolným dotazem lze znovu zaøadit do dotazu jako zpìtnou vazbu. Pokud se rozhodnete získat dal¹í sadu dokumentù z nìjakého z pøede¹lých dotazù, mù¾ete tak uèinit z pøíslu¹ného formuláøe Results tlaèítkem Retrieve next.

Tlaèítkem Run Query na formuláøi celkové specifikace dotazu spustíte dotaz. Poté se zobrazí nový formuláø s tabulkou výsledkù. Rychlost zobrazení výsledkù se mù¾e v závislosti na dobì odezvy sítì mìnit. V dobì kdy èekáte na výsledky ji¾ ale mù¾ete napø. specifikovat jiný dotaz, pøípadnì s AdminAgentem jinak pracovat.

Následující odstavce popisují dal¹í mo¾nosti práce s výsledky dotazù.

Výsledkem dotazu je mno¾ina dokumentù, které server vrátí jako relevantní k dotazu. Základní informace o nalezených dokumentech (název, URL apod.) jsou pøehlednì zobrazeny ve výsledkové tabulce. Detailní popis získáme oznaèením daného dokumentu a zobrazením podrobností v sekci Document Details.

S výsledky dotazu lze dále pokroèilým zpùsobem pracovat. Je mo¾né kopírovat vybrané øádky do schánky (pou¾ijeme k tomu pravého tlaèítka my¹i) a zále¾í jen na u¾ivateli, jak je vyu¾ije dále. Kopírování lze provádìt hned tøemi zpùsoby:

• Copy URL(s) - zkopíruje jeden nebo více vybraných URL
• Copy row(s) - zkopíruje jeden nebo více vybraných øádkù, sloupce øádkù oddìlí støedníkem
• Copy with details - zkopíruje jeden nebo více vybraných dokumentù vèetnì v¹ech parametrù s popisky

Aby se maximálnì usnadnila práce s výsledky, je navíc mo¾né pøímo z AdminAgenta spustit externí webovský prohlí¾eè s parametrem URL vybraného dokumentu a to velmi jednodu¹e opìt pøes nabídku zobrazenou pravým tlaèítkem my¹i. Zvolené dokumenty je mo¾no znovu zaøadit do dotazu jako zpìtnou vazbu a tím tak dotaz obohatit.

Pøíklady dotazù

Zde si uvedeme dva vzorové pøíklady jak formulovat dotaz. Pøíklady vyu¾ívají pouze tøí komponent specifikace dotazu (slova, hlavièka dokumentu, zpìtná vazba). Ov¹em pou¾ití dal¹ích dvou komponent (celý dokument se známým URL, odstavec textu) je zcela analogické a proto to zde není dále detailnìji popisováno.

Jednoduchý dotaz:

Øeknìme, ¾e chceme vyhledat dokumenty, týkající se pìstování kvìtin, jejich hnojení, ale nezajímá nás hnojení umìlými hnojivy. Zajímají nás jen dokumenty psané v èeském jazyce. Dotaz mù¾eme polo¾it napø. následujícím zpùsobem: Ve stromu vybereme uzel Words (ve vìtvi Query, New Query Specification) a v nìm vyplníme dotaz, tj. napø.: "pìstování kvìtin" hnojení hnojivo umìlé Pod uzlem Words se nyní vytvoøily uzly:

• "pìstování kvìtin"
• hnojení
• hnojivo
• umìlé

Vybereme uzel umìlé a nastavíme jeho váhu (weight) na -1. Tím tento term maximálnì znevýhodníme. Pod uzlem Header specifikujeme jazyk, vybereme tedy CZE. Zvolíme uzel New Query Specification. Pokud chceme, aby se dotaz vyhodnocoval jen v nìkterých knihách mù¾eme je nyní zvolit nebo nechat listbox Books prázdný a tím nechat dotaz na celou databázi. Zmaèkneme tlaèítko Run Query a na formuláøi pod uzlem Results si pøeèteme první výsledky. Tlaèítkem Retrieve Next je mo¾no získat dal¹í.

Dotaz se zpìtnou vazbou:

Obrovskou výhodou systému je, ¾e umo¾òuje tzv. zpìtnou vazbu. Zpìtnou vazbou ve smyslu dotazování v systému Agent rozumíme dokumenty, které nám server vrátil jako výsledek dotazu, my je oznaèili za relevantní a pøidali je do nového dotazu.

Øeknìme, ¾e se nám v minulém dotazu objevilo velké mno¾ství dokumentù, které ne zcela vyhovovali na¹im pøedstavám. Jednou ze standardních mo¾ností jak dotaz vylep¹it, aby nás svými výsledky lépe uspokojil, je pøidat do dotazu nìkolik dal¹ích slov, upravit váhy a tak podobnì. Jinou pohodlnìj¹í a jistìj¹í mo¾ností je jednodu¹e oznaèit ty vrácené dokumenty, které pova¾ujeme za relevantní. ©ance, ¾e pøi dal¹ím dotazu dostaneme více relevantních dokumentù se tak podstatnì zvý¹í.

Zvolíme tedy uzel Results a oznaèíme malé mno¾ství dokumentù, které pova¾ujeme za nejvíce relevantní. Tlaèítkem Add to new query je zahrneme do dotazu. Pod uzlem Feedback si mù¾eme seznam tìchto dokumentù prohlédnout a dále upravit jejich váhu (weight). Zmaèkneme tlaèítko Run Query a na formuláøi pod uzlem Results si pøeèteme první výsledky. Tlaèítkem Retrieve Next je mo¾no získat dal¹í.

9.3.3 Správa systémových parametrù a parametrù sezení

Server jako takový má nastaveny systémové parametry, které se pou¾ijí pøí zalo¾ení ka¾dého nového sezení. Administrátor systému mù¾e v¹echny tyto parametry mìnit a tak ovlivnit poèáteèní chování systému po zalo¾ení ka¾dého nového sezení. Kromì toho, lze v¹ak tyto parametry nastavit také v ka¾dém sezení zvlá¹». Parametry sezení tedy smí ovlivòovat i obyèejný u¾ivatel (pøihlá¹ený jako guest).

Systém má tyto parametry:

• default database - databáze, na které probíhají dotazy, po tom co se u¾ivatel napojí na server (tj. zøídí nové sezení)
• timeout - èas (v min.), po který zùstává aktuální sezení otevøeno. Pokud po tuto dobu u¾ivatel nekomunikuje se serverem, sezení se uzavøe.
• output count - max. poèet dokumentù vrácených najednou jako výsledek dotazu.
• language - jazyk ve kterém probíhají dotazy

Jejich nastavování a kontrola se provádí na formuláøi System Config vyjma parametru default database je¾ se volí formuláøem v uzlu Databases.

Z tìchto systémových parametrù si ka¾dé sezení po napojení na server zkopíruje vlastní parametry:

• active database
• timeout
• output count
• language

Nastavování parametrù sezení se provádí analogicky v poduzlu Session Config (aktivní databáze v jeho poduzlu Database)

9.3.4 Správa databází dokumentù

Indexy dokumentù se mohou nacházet v jedné nebo více databázích. Databáze se mohou nacházet v tìchto dvou základních stavech:

• otevøená - s databází je mo¾no normálnì pracovat, tj. pokládat dotazy, indexovat dokumenty atd., z hlediska administrace lze nìkterou z nich zvolit jako výchozí, provést na ni reorganizaci a dále indexovat dokumenty, mìnit stoplist atd.
• uzavøená - s databází není mo¾no pracovat, její obraz je ulo¾en pouze na disku, z hlediska administrace lze databázi, vytvoøit, pøejmenovat nebo smazat

Tomuto dìlení odpovídají ve formuláøi Databases dva seznamy:

• seznam v¹ech databází
• seznam otevøených databází

Pod uzlem Databases najdete jako uzly stromu v¹echny databáze, které jsou v daném okam¾iku otevøené. Ty mají své poduzly, reprezentující objekty pro práci s ka¾dou z nich. Jednotlivé poduzly nabízejí správu knih a stoplistu, formuláøe pro indexování dokumentù a jejich pøípadné odstraòování i statistické údaje.

Pøíklady indexování dokumentù, tvorba stoplistu

Indexování jednoho dokumentu:

Indexování dokumentu je stejnì jednoduché jako jakákoliv jiná práce s AdminAgentem. Øeknìme, ¾e chceme zaindexovat jeden soubor nacházející se na adrese:

http://www.kolej.mff.cuni.cz/~jger4112/projekt/docs/rel/a4.html

chceme ho ulo¾it do knihy: "Softwarové projekty" a dále je o nìm známo, ¾e je napsán ve formátu HTML.

Vybereme pøíslu¹ný formuláø New Document. Nachází se v podstromu Administration pod v¹emi otevøenými databázemi. Vybereme tu správnou databázi, zadáme url dokumentu (mù¾eme pøitom pou¾ít cut&paste), za¹krtneme Add this one, a vybereme pøíslu¹nou knihu, do které chceme soubor zaøadit. V podformuláøi Header potom vybereme typ dokumentu. Polo¾ky hlavièky ale není nutné takto explicitnì zadávat, server je schopen zjistit napø. typ dokumentu sám. Mù¾e to v¹ak znamenat urychlení indexace. Zmaèknìte tlaèítko Add. Nyní mù¾ete dále pracovat, není tøeba èekat a¾ server indexaci dokonèí. Dokonèení indexace aplikace oznámí dialogovým oknem.

Automatické indexování vìt¹ího mno¾ství dokumentù:

Pokud bychom chtìli zaindexovat vìt¹í mno¾ství dokumentù, vý¹e zmínìný zpùsob indexování by byl velmi namáhavý a èasovì neúnosný. Proto byla implementována také mo¾nost indexování pomocí indexovacího souboru. Indexovací soubor je soubor s jednoduchou strukturou, v nìm¾ jsou uvedeny soubory k indexování a parametry. Pou¾ití indexovacího souboru je velmi výhodné. Díky jeho jednoduché struktuøe je mo¾né jej vytvoøit ruènì, nebo napsat jednoduchý program, který jej vytváøí na základì nìjakých kritérií. Pro tvorbu indexovacího souboru mù¾ete pou¾ít nástroje flcreat.exe, který je standardnì souèástí balíku. Ten vytváøí seznam dokumentù v¹ech souborù vèetnì podadresáøù od zadané cesty.

Postup indexování je obdobný jako v pøedchozím pøípadì. Vytvoøíme indexovací soubor. Vybereme formuláø New Document. Zadáme url indexovacího souboru a za¹krtneme Add documents from index file. Nezbývá ne¾ zmaèknout tlaèítko Add. Podobnì jako v pøedchozím pøípadì jste o výsledku indexování informováni dialogovým oknem.

Automatické pøidání stoplistu z souboru

Podobnì jako indexování vìt¹ího poètu dokumentù, tvorba stoplistu pouhým pøidáváním jednotlivých slov by byla neúnosná. Proto je mo¾no stoplist naplnit pomocí souboru. Nejprve vytvoøte (ruènì nebo programovì) soubor se seznamem termù je¾ chcete do stoplistu pøidat. V pøíslu¹né databázi ve formuláøi Stoplist do políèka New term/stoplist file URL napi¹te URL tohoto souboru. Za¹krtnìte Add terms from stoplist file. Zmaèknìte tlaèítko Add.