Uºivatelská p íru ka Octopus Jan Bojko 11. prosince 2014 Abstrakt Uºivatelská p íru ka k aplikaci Octopus. Obsah 1 Úvod 2 2 P ihlá²ení 2 3 Naviga ní menu 2 4 Práce s tabulkou 3 5 Editace 6 5.1 Nový záznam............................. 6 5.2 Hromadná editace.......................... 7 5.3 Export tabulek............................ 8 6 Mapa 9 7 Vztahy a vazby 10 7.1 P iloºení................................ 10 7.2 Zobrazení............................... 11 8 Moduly 12 8.1 Nást nka............................... 12 8.2 Revize................................. 13 8.3 Poruchy................................ 14 9 Nastavení 16 10 Správa uºivatel 16 10.1 Uºivatelské role (role)........................ 17 10.2 Uºivatelské skupiny (group)..................... 18 10.3 Rozsah (scope)............................ 19 10.4 Akce (action)............................. 19 1
1 Úvod Octopus je geoinforma ní souhrné e²ení v oblasti teplárenství, obsahuje adu modul pro preventivní údrºbu, poruchovou sluºbu a dal²í podp rnou funkcionalitu. Webová aplikace si klade za cíl usnadnit práci uºivatel m nap í ²irokým spektrem pracovních pozic od udrºbá e po management. Webové e²ení se skládá z n kolika ástí, které slouºí k zobrazeni, vytvá ení a editaci prostorových i atributových dat. 2 P ihlá²ení Systém authetikace a autorizace je ízen Spring Security frameworkem, který ídí p id lování sezení pro klienta. V sou asné dob je na stran serveru uºivatel authentikován podle databáze MSSQL. Av²ak systém je otev ený a umoº uje napojení prakticky na jakýkoliv mechanismus. 3 Naviga ní menu Obrázek 1: P ihla²ovací okno Naviga ní strom funguje jako rozcestník a umoº uje p istupovat k jednotlivým modul m aplikace. P idanou funkcionalitou je funkce vyhledávání, moºnost strom svinout a rozvinout. Sekce ve stromu se také ídí podle správy uºivatel, coº znamená, ºe ur ité role mají p ístup pouze k ur itým oblastem aplikace. 2
4 Práce s tabulkou Obrázek 2: Naviga ní menu Data se zobrazují v podob tabulky, po et záznam m ºe být omezen stránkováním nebo ltrováním. Stránkování p edstavuje maximální po et záznam ( ádk ), které se mohou zobrazit v tabulce. Kaºdá tabulka má v horní nástrojové li²t soubor ovládacích tla ítek, které se zobrazují podle uºivatelského oprávn ní. Uºivatelé mohou provád t r zné operace na základ jejich pracovního za azení, IT administrátor m ºe p idávat a editovat uºivatele, technik m ºe editovat data, údrºbá m ºe data pouze zobrazovat apod. Obrázek 3: Zobrazení tabulky Filtrace je d leºitá pro omezení výb ru záznam v tabulce a tak získání 3
pot ebné informace. Aplikace umoº uje ltrovat podle r zných typ polí: datumu, textu, ísla apod. Kaºdá tabulka má nastavené sloupce, podle kterých je moºné ltrovat obsah. Sloupce, které ltraci umoº ují mají v jejich menu poloºku ltry, která má podobu podle druhu (datového typu) sloupce. Pro p edstavu sloupce typu datum umoº ují zadávat hodnoty do kalendá e, íselná data mohou být omezená podmínkami v t²í, rovno a men²í (obrázek 5) a n které mohou mít pouze ur itý výb r moºností, jsou navázané na íselníky viz. obrázek 4. Obrázek 4: Filtrování podle moºností 4
Obrázek 5: Filtrování podle íselných hodnot Filtrování podle íselných hodnot Aktivní ltry m ºeme poznat podle tla ítka Vypnout aktivní ltry, pokud je stla ené tak signalizuje, ºe jsou zobrazená data omezena podle n jaké podmínky. Zmá knutím tohoto tla ítka m ºeme deaktivovat v²echny ltry a zobrazit kompletní obsah tabulky. Obrázek 6: Zru²ení aktivních ltr Dolní nástrojová li²ta (obrázek 7) slouºí p edev²ím ke stránkování a obnovení dat. Aplikace na ítá pouze 50 ádk na stránku, aby nedocházelo k zatíºení prohlíºe e velkým objemem dat. Pomocí jednoduchých ²ipek m ºeme o stránku vp ed a zp t, sloºené ²ipky p edstavují pohyb na poslední a první stranu, dále je také moºné zadat p ímo konkrétní stranu. Kruhové ²ipky slouºí k obnovení dat z databáze. 5
Obrázek 7: Nástrojová li²ta tabulky 5 Editace Editace záznam se provádí s pouºitím nejr zn j²ích nástroj. D leºitou vlastností aplikace Octopus je, ºe editace probíhá na stran klienta, a proto nesta í záznam upravit jako v b ºných kancelá ských balících, ale je nutné jej také uloºit. 5.1 Nový záznam Obrázek 8: Editace Pokud je vytvo en nový záznam, aplikace automaticky p idá ádek na za átek tabulky s n kterými p edvypln nými údaji. Je pot eba provést editaci aspo jednoho pole, aby byl p i odeslání zm n brán tento záznam v potaz. Pokud p i editaci uºivatel p idá dal²í záznam, dojde k automatickému ukon ení editace poloºky a uloºení zm n. 6
5.2 Hromadná editace Obrázek 9: Vloºení nového záznamu V aplikaci je moºné vyuºít hromadnou editaci sloupce (obrázek 10), coº slouºí k editování jednoho sloupce u více ádk najednou. P ed zahájením hromadné editace musí uºivatel, bu vybrat ádky pomocí tla ítka my²í p i stisknutých tla ítcích Shift nebo Ctrl (volba Ozna ené), a nebo pouºít volbu Zobrazené, která ozna í v²echny záznamy na aktuálním listu. Klik na tla ítko zahájí hromadnou editaci a dot ené ádky se obarví viz. 11. Obrázek 10: Hromadná editace Nástroj funguje tak, ºe se provede editace jednoho polí ka a hodnota se poté replikuje do v²ech ostatních polí ek v daném sloupci v záznamech vybraných pro 7
hromadnou editaci. Editace polí ka probíhá standardn výb rem z íselníkových hodnot, výb rem data z kalendá e, nebo p ímým zápisem ísla nebo textu. Po editaci se zm na potvrdí klávesou enter. Jelikoº p i pouºití hromadné editace je vet²í riziko uºivatelských chyb, je vhodné po kaºdé editaci sloupce uloºit zm ny pomocí tla ítka uloºit. Po uloºení lze editovat dal²í sloupec. Obrázek 11: Hromadná editace Obrázek 12: Hromadná editace P i editaci nových ádku se postupuje podle návodu uvedeného vý²e, tedy jejich výb rem a kliknutím na tla ítka hromadné editace. Po ukon ení hromadné editace je vhodné hromadnou editaci ukon it kliknutím na tla ítko ukon it, které se nachází v rozbalovací nabídce hromadné editace. k 5.3 Export tabulek Data zobrazené pomocí aplikace Octopus je moºné exportovat do dokument ve formátech pdf, xls, nebo xlsx. Z vybraných formát si uºivatel vybere jeden pomocí rozbalovacího menu a následn se exportují v²echny aktuáln vy- ltrované záznamy dané tabulky. Uºivatel si zvolí název a místo exportovaného souboru a tím export dokon í. K správné funk nosti exportu je nutné v prohlíºe i 8
povolit automaticky otev ené okno. Export do t chto soubor probíhá na základ p eddenovaných ²ablon, ve kterých se denuje,struktura, obsah a vzhled výsledných soubor. Obrázek 13: Tla ítko pro export do.xls 6 Mapa Obrázek 14: Exportovaná tabulka do.xls Samostatnou sou ástí aplikace Octopus je mapová ást zaji² ovaná mapovým serverem. V t²ina objekt evidovaných v aplikaci má vlastní grackou reprezentaci v map. V ovládacím panelu jednotlivých tabulek se nachází tla ítko pro p echod do mapy. Po kliknutí na n j si lze zobrazit ozna ené nebo aktuální objekty v map. V samostatném okn se poté otev e mapa s podkladovými vrstvami p iblíºena na vybrané objekty. Následn lze v map pracovat nezávisle na práci v aplikaci. 9
7 Vztahy a vazby Obrázek 15: Tla ítko pro zobrazení v map Krom gracké reprezentace objekt v tabulce m ºe být na n navázána n jaká akce, soubor, událost apod. íkáme, ºe mají n jaký vztah i vazbu. Pod souborem si m ºeme p edstavit smlouvu, technickou dokumentaci i obrázek, pod akcí a událostí pak plánovanou revizi i nahlá²enou poruchu. Níºe si v²e p edvedeme na dokuementech. 7.1 P iloºení P iloºení n jaké vazby na akci i soubor je nutné aplikovat na n jaký konkrétní objekt, musí být zvolen jeden ádek v tabulce. Poté je moºné zvolit z menu pro p iloºení moºnost, která je pro danou tabulku nastavena, coº je znázorn no na obrázku 16. Obrázek 16: P iloºení dokumentu k objektu 10
Typickým p íkladem p iloºení m ºe být soubor, který bude pak uloºen do databáze spolu s daným objektem. Na obrázku 17 je znázorn no p iloºení dokumentu technické dokumentace k vybranému objektu v tabulce. 7.2 Zobrazení Obrázek 17: Nahrání souboru V p ede²lé kapitole jsme si ukázali jak p iloºit soubor k objektu, nyní si ukáºeme jak zobrazit v²echny dokumenty, které k objektu náleºí. Nejprve zjistíme, jestli je k objektu p iloºen n jaký dokument. V tabulce je sloupec s ikonou dokumentu, pokud na n ho ukáºeme kurzorem, tak se zobrazí po et p iloºených dokument. M ºe se stát, ºe k danému ádku nebyl je²t p iloºen ºádný soubor, pak ikona ve sloupci chybí (viz. 18). Ikona dokumentu funguje i jako aktivní tla ítko, p i kliknutí dojde k p idání tabulky s dokumenty s ltrem, a proto budou zobrazeny jen dokumenty, které náleºí k p íslu²nému objektu (viz. 19). Obrázek 18: Záznamy s p iloºenými dokumenty Ikona dokumentu funguje i jako aktivní tla ítko, p i kliknutí dojde k p idání tabulky s dokumenty s ltrem, a proto budou zobrazeny jen dokumenty, které náleºí k p íslu²nému objektu (viz. 19). Tabulka slouºí také p ímému staºení 11
souboru, který je uloºený v databázi, staºení lze uskute nit pomocí ikony s ²ipkou. Tabulka dokument slouºí pro p ístup ke v²em dokument m, a proto je kaºdý záznam ( ádek) navázán k objektu. Pro jeho zobrazení pouºijte ²ipku. 8 Moduly Obrázek 19: Zobrazení dokument v tabulce Moduly p edstavují dopl kovou funkcionalitu v aplikaci Octopus. Funkce mohou být vizuáln reprezentovány tla ítkem, formulá em, tabulkou apod. Zaleºí na druhu licence, kterou má uºivatel pro svou instalaci k dispozici. Mezi d leºité moduly pat í modul nást nky, revizí a poruch viz. níºe. 8.1 Nást nka Modul nást nka je velice komplexní nástroj a m ºe u kaºdého uºivatele i instalace vypadat jinak. Slouºí k zobrazení souhrných informací pro uºivatele. Kaºdý uºivatel má v organizaci jinou úlohu, a proto ho mohou zajímat rozdílná data nap. graf spot eby, mapa poruch, plánované revize nebo novinky v organizaci. Obrázek 20: Nást nka V sou asné verzi umoº uje zobrazit mapu, graf, tabulku, kalendá atd. Tyto komponenty pak mohou být vizuáln uspo ádány podle pot eb uºivatele. 12
Obrázek 21: Nást nka s mapou a tabulkou 8.2 Revize Revize umoº ují zaznamenat a naplánovat revizi k n jakému objektu. Nejprve vybereme v tabulce objekt ( ádek), který má být podroben revizi. Dále za pomoci menu p iloºit zvolíme moºnost p idání nové revize. Obrázek 22: P idat novou revizi Zobrazí se formulá (obrázek 22), který slouºí k p idání nové revize. Po zadání v²ech povinných polí zmá kneme tla ítko Odeslat, revize bude vloºena do databáze a navázána na objekt. Jestli má ur itý objekt naplánovanou i zaznamenanou revizi indikuje tla ítko ve sloupci Revize na p íslu²ném ádku (viz. 26). 13
Obrázek 23: Zaloºení revize Formulá (obrázek 22) umoº uje zadavatelu vloºit Datum innosti i Datum spln ní zárove, v tomto p ípad aplikace doporu í zaloºit následující revizi pomocí Datum dal²í innosti. Datum této innosti v²ak musí být v pozd j²í neº datum innosti, pokud tomu tak není aplikace na to uºivatele upozorní a neumoºní uºivateli pokra ovat (obrázek 23). Obrázek 24: Chyba p i zaloºení revize 8.3 Poruchy Poruchy umoº ují zaznamenat poruchu k n jakému objektu. Nejprve vybereme v tabulce objekt ( ádek), u kterého má být nahlá²ena porucha. Dále za pomoci menu p iloºit zvolíme moºnost p idání nové poruchy. 14
Obrázek 25: P idat novou poruchu Zobrazí se formulá (obrázek 25), který slouºí k nahlá²ení nové poruchy. Po zadání v²ech povinných polí zmá kneme tla ítko Odeslat, porucha bude vloºena do databáze a navázána na objekt. Jestli má ur itý objekt nahlá²enou poruchu indikuje tla ítko ve sloupci Poruchy na p íslu²ném ádku (viz. 26). Obrázek 26: Zaloºení poruchy 15
9 Nastavení Obrázek 27: Indikace poruch a revizí u objektu Panel nastavení umoº uje m nit chování aplikace, zobrazit nápov du nebo se odhlásit. Po za²krtnutí tla ítka Mapa okno (viz. 27) se budou nové mapové okna otevírat do jednoho, nebude tedy docházet k otvírání nových tab /oken prohlíºe e. Tla ítko Smazat stav slouºí k vrácení aplikace do základního stavu jako po úpln prvním p ihlá²ení do aplikace. Tla ítko Helpdesk odkazuje na kontaktní místo pro uºivatele a zákazníky. Vedle menu tla itka nastavení se nachází tla itko mapy, které slouºí pro rychlý p echod do mapové ásti aplikace. Práce v této ásti aplikace pak probíhá do jisté míry nezávisle na atributové. 10 Správa uºivatel Obrázek 28: Panel nastavení Uºivatel je jednozna n denován svými p ihla²ovacími údaji - jménem a heslem. Authentikace probíhá po zadání t chto údaj do aplikace, av²ak aby mohl aplikaci pouºívat je nutné ho autorizovat. Na základ denice rolí, skupin, rozsahu a akcí je schopen provád t ur ité innosti v ur itých aplika ních ástech. 16
10.1 Uºivatelské role (role) Obrázek 29: Editace uºivatele Slouºí k ur ení práv v rámci systému Octopus, nap. ADMINISTRATOR m ºe být role, která má nejvy²²í pravomoci. V sou asné dob odli²ujeme role Administrator, Editor, User a Anonymous. 17
Obrázek 30: Editace role 10.2 Uºivatelské skupiny (group) Uºivatelské skupiny slouºí k odli²ení jednotlivých uºivatel v rámci jejich pracovních pozic. Ur ují obsah, který m ºe pracovník vid t. Nap. Director, IT_Manager, Employer Obrázek 31: Editace uºivatelské skupiny 18
10.3 Rozsah (scope) Rozsah slouºí k denování okruhu, ve kterém se uºivatel m ºe pohybovat. editel m ºe vid t v²e, zam stnanec údrºby m ºe vid t pouze poruchovou sluºbu. Rozsah má vliv na uºivatelské role. 10.4 Akce (action) Akce slouºí k denování r zných inností v aplikace. ACT_ADD muºe p edstavovat akci p idání nového záznamu. Akce jsou ovlivn ny rozsahem (rolema), m ºeme proto nadenovat v kterém díl ím modulu lze editovat tabulky. 19