Pravidla a plánování Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o. Třebohostická 987/5 100 00 Praha 10 tel.: 234 052 111 fax.: 234 052 999 e-mail:
[email protected] http://www.ttc-telekomunikace.cz Datum vydání: 7. května 2013 Číslo dokumentu: 466C008.624.00.N01 Číslo verze SW: 2.4.0
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
Obsah 1 2
Úvod ................................................................................................................................... 3 Stručný popis systému ........................................................................................................ 3 2.1 Spuštění systému ........................................................................................................ 3 2.2 Popis grafického rozhraní........................................................................................... 3 3 Konfigurace systému .......................................................................................................... 5 3.1 Záložka Plánování ...................................................................................................... 5 3.1.1 Vytvoření plánu .................................................................................................... 5 3.1.1.1 Zadání času spuštění ..................................................................................... 6 3.1.2 Editace plánu ........................................................................................................ 7 3.1.3 Odstranění naplánovaného úkolu z plánování ..................................................... 7 3.2 Záložka Pravidla ......................................................................................................... 8 3.2.1 Vytvoření pravidla................................................................................................ 9 3.2.1.1 Sestavení výrazu ......................................................................................... 10 3.2.1.2 Časové omezení pravidel ............................................................................ 11 3.2.2 Editace pravidel .................................................................................................. 12 3.2.1 Odstranění pravidla a změna pořadí pravidel ..................................................... 12 4 Odkazy ............................................................................................................................. 12
466C008.624.00.N00
2
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
1 Úvod Tento dokument popisuje nastavení parametrů pravidel a plánovaného spouštění akcí na platformě SIMPHONY. Je určen pro administrátory systému.
2 Stručný popis systému Popisovaný systém se skládá ze dvou hlavních částí: serverové a mobilní aplikace. Serverová aplikace je určena pro vytvoření, řízení a sledování pochůzek a pro řešení nestandardních situací. Umožňuje i jednoduchou statistiku pochůzek, jejich plánování a stanovení pravidel. Nastavení systému popisované v tomto dokumentu se provádí na serverové aplikaci. Aplikace na mobilním telefonu slouží jako pochůzkový terminál pro pochůzkový systém – viz [1]. Tento systém je možné doplnit „Svolávacím systémem“ pro řešení krizových situací, viz [3] a [4] a dohledový systém [5]
2.1 Spuštění systému Pro spuštění aplikace je nutný internetový prohlížeč Firefox. Po zadání určené adresy (např. https://www.simphony.cz) se zobrazí úvodní obrazovka, viz obr. 2-1. Po zadání registrovaného emailu a hesla stiskneme tlačítko Přihlásit.
Odkaz na další informace o systému
Tlačítko „Přihlásit“
Odkaz na mobilní aplikaci
obr. 2-1 Úvodní přihlašovací obrazovka
2.2 Popis grafického rozhraní Po přihlášení se otevře stránka znázorněná na obr. 2-2. Obrázek ukazuje příklad grafického rozhraní se základním popisem důležitých prvků. Nastavení Pochůzek, Pochůzkových bodů a Uživatelů je věnován uživatelský manuál [1]. V něm je rovněž popsána záložka Historie z hlediska pochůzek. Předmětem tohoto dokumentu je popis Plánování a Pravidel. Plánování umožňuje nastavit spouštění pochůzek v určitých zadaných časech, Pravidla slouží k nastavení pravidel pro řešení krizových situací.
466C008.624.00.N00
3
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o. Zobrazit / skrýt spuštěné procesy
Pravidla a plánování
Horní menu
Horní lišta Nastavení uživatelů
Zobrazit / skrýt spuštěné pochůzky
Vytváření a editace procesů „Svolávacího systému“
Zobrazení historie pochůzek
Zobrazení logu
Nastavení pravidel
Nastavení plánování
Spuštěný, nepotvrzený proces
Aktuální pochůzka
obr. 2-2 Grafické rozhraní pochůzkového systému SIMPHONY
Pro zvýšení přehlednosti lze v levé části nastavit filtr pro zobrazované události, t.j zleva tlačítka pro zobrazení spuštěných procesů, tlačítko pro zobrazení spuštěných pochůzek, tlačítko pro zobrazení mapových podkladů a tlačítko pro zobrazení kamerových pohledů. V současné verzi nejsou dvě poslední zmíněná tlačítka v systému implementována. Levé tlačítko slouží pro „Svolávací systém“.
Zobrazit/skrýt aktivity procesu
Zobrazit/skrýt levé menu
Zobrazit/skrýt horní menu
Přihlášený uživatel
Zobrazení manuálů
Volba jazyka
Tlačítko pro odhlášení
obr. 2-3 Horní lišta
Na obr. 2-3 je detail horní lišty. Zde je možno skrýt a opětovně zobrazit levé a horní menu. Využití zejména v případě rozsáhlých pochůzek, kdy vhodným nastavením lze získat větší plochu pro zobrazení. Dále je zde údaj o přihlášeném uživateli. Po kliknutí na jméno přihlášeného uživatele se otevře menu, kde mohu editovat jeho osobní údaje. Více v kapitole o editaci uživatelů v [1]. Kliknutím na nápovědu se zobrazí seznam odkazů na manuály. Volbu jazykové mutace provádíme po kliknutí na vlaječku a následným výběrem jazyka z výběrového menu. V současné době lze vybírat z české, anglické a polské lokalizace.
466C008.624.00.N00
4
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
3 Konfigurace systému 3.1 Záložka Plánování Upozornění: V následujícím textu je popisováno plánování pochůzek a procesů, ale plánování procesů je v Plánování možné pouze v tom případě, že je implementován také „Svolávací systém“. Pokud není implementován, lze plánovat pouze pochůzky. Plánování umožňuje připravit automatické spuštění pochůzek nebo procesů. Po kliknutí na záložku Plánování v horním menu se zobrazí seznam dosud naplánovaných spuštění pochůzek nebo procesů s jejich základními údaji, viz obr. 3-1. V posledním sloupci každého záznamu jsou dvě tlačítka, jedno pro editaci a druhé pro odstranění úkolu. Zcela nahoře vlevo je tlačítko Vytvořit pro zadání nového plánu.
Informace o uložení nově vytvořeného plánu
Vytvořit nový plán
obr. 3-1 Seznam plánů
3.1.1 Vytvoření plánu Po kliknutí na tlačítko Vytvořit (obr. 3-1) se zobrazí prázdný editační formulář, viz obr. 3-2. V prvním poli můžeme plán popsat, ale není to povinné. Dále následují údaje o čase spuštění. Plán lze spustit jednou, nebo je možné zadat opakované spouštění. Pravidla pro zadávání časových údajů jsou podrobněji popsána v samostatné kapitole 3.1.1.1. Dále zvolíme, o jaký typ plánu se jedná – vybereme pochůzku nebo proces. Po výběru dojde k aktualizaci položky Spustit a můžeme vybrat konkrétní pochůzku nebo proces, který se má spustit. V případě, že je vybrána pochůzka, je zviditelněna položka „Pochůzkář“, kde můžeme vybrat konkrétního pochůzkáře nebo „Roli“. Pokud je vybrán proces, je zviditelněna položka „Automatické zpracování“, která je implicitně zaškrtnuta, tedy spuštěný proces proběhne automaticky. Odškrtnutím lze nastavit manuální zpracování procesu. Zadané údaje uložíme tlačítkem Uložit. Pokud nechceme nový plán uložit, stiskneme tlačítko Zrušit. V obou případech se vrátíme do seznamu naplánovaných úkolů.
466C008.624.00.N00
5
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
Popis plánu Spustit proces nebo pochůzku
Přiřazení pochůzky roli nebo uživateli Automatické zpracování procesu
obr. 3-2 Editační formulář
3.1.1.1 Zadání času spuštění Časy se zadávají podle specifikace EJB Timer Service (JSR 318), viz [2]. Pro běžné zadání data a času do formuláře dostačují následující pravidla. Pole pro čas nebo datum nesmí být prázdné, kromě polí Začátek a Konec. Tomu odpovídají i implicitní hodnoty, které vidíme na obr. 3-2. Podle těchto implicitních hodnot by byl úkol spuštěn každý den o půlnoci, protože číslo 0 zde znamená určitý čas, zatímco * představuje jakoukoli hodnotu. Jestliže je ve všech datových polích zadaná *, pak to znamená každý den. Značka * zadaná v poli Hodina by představovala spuštění každou hodinu. Jestliže je v některém poli pro den zadané konkrétní číslo, má tato konkrétní zadaná hodnota přednost před značkou *. Např. hodnota 1 v poli „Den v týdnu“ znamená spuštění každé pondělí, i když je v poli „Den v měsíci“ značka *. Do políček lze zadat i více hodnot oddělených čárkou. Např. zápis na obr. 3-3 znamená spuštění každý pracovní den v 19 hodin.
obr. 3-3 Příklad zadání času spuštění
V zadání času nebo data lze použít i operátor /. */x znamená každých x, tedy např */2 znamená každý druhý, y/x znamená každých x, se začátkem y.
466C008.624.00.N00
6
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
Při zadávání úlohy je možné omezit ji pouze na určitý časový úsek, k tomu slouží pole Začátek a Konec. K zadání data klikneme na ikonu kalendáře a pak se otevře okno kalendáře jako na obr. 3-4. Dnešní datum lze vybrat kliknutím na tlačítko Dnes, jiné datum se vybere kliknutím na příslušné políčko. Vybereme-li datum a stiskneme tlačítko Použít, uloží se nám vybrané datum do příslušného pole s implicitní hodinou 12:00. Chceme-li nastavit jinou hodinu, klikneme na otevřeném kalendáři na tlačítko pro nastavení hodin a otevře se menu pro nastavení hodiny.
Posun o měsíc
Posun o rok Nastavení hodiny Uzavření okna kalendáře
Otevření menu pro hodiny Vybrané datum Zadání vyznačeného data
obr. 3-4 Příklad zadání data
3.1.2 Editace plánu Po stisku tlačítka Upravit v řádku příslušného úkolu v seznamu naplánovaných úkolů na obr. 3-1 se zobrazí editační formulář (viz obr. 3-2), ovšem s vyplněnými údaji a je možné údaje upravit. Uložení změněných údajů se provede tlačítkem Uložit, editace se zruší a původní údaje se zachovají po stisku tlačítka Zrušit.
3.1.3 Odstranění naplánovaného úkolu z plánování V případě potřeby je možné celý úkol z plánovače odstranit. Provádí se stiskem tlačítka Odstranit, které je v pravém sloupci v příslušném řádku (obr. 3-1). Akci odstranění úkolu je nutno potvrdit, viz následující obrázek.
466C008.624.00.N00
7
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
obr. 3-5 Odstranění úkolu
3.2 Záložka Pravidla Při provádění pochůzek mohou nastat různé nestandardní situace. Pravidla umožňují definovat konkrétní takové situace a zároveň definovat reakci systému. Pokud nemáme dosud definovaná žádná pravidla, pak při kliknutí na záložku Pravidla se otevře stránka viz obr. 3-6. Po kliknutí na výběrové menu se otevře seznam základních typů nestandardních situací (událostí), viz obr. 3-7. Pro tyto jednotlivé typy událostí lze nadefinovat pravidla případným zpřesněním podmínek pro uplatnění pravidel (pomocí výrazu) a definováním reakce v případě, že daná podmínka nastane.
obr. 3-6 Stránka Pravidel
obr. 3-7 Typy nestandardních situací
466C008.624.00.N00
8
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
3.2.1 Vytvoření pravidla Při vytváření pravidel si nejdříve vybereme typ situace z výběrového menu na obr. 3-7. Po výběru typu situace klikneme na tlačítko Vytvořit, viz obr. 3-6 a tím se otevře formulář pro vytvoření pravidla, viz obr. 3-8. Kvůli přehlednosti postupujeme při následném popisu vytváření pravidla shora dolů. V prvním řádku je vypsán typ situace, který jsme zvolili v předchozím kroku. Pod ním je pole Popis, kde lze pravidlo popsat slovy. Následuje zaškrtávací políčko „Propustit událost dále“. V případě, že je zaškrtnuto, pak po uplatnění aktuálního pravidla se pokračuje ve vyhodnocování dalších pravidel. Pokud není zaškrtnuto, pak po uplatnění aktuálního pravidla je událost ukončena. Dále zvolíme typ reakce na splněnou podmínku (vybraná událost a výraz = true), tedy vybereme pochůzku nebo proces.1 Po výběru dojde k aktualizaci položky Spustit a můžeme vybrat konkrétní pochůzku nebo proces, který se má spustit. V případě, že je vybrána pochůzka, je zviditelněna položka „Pochůzkář“ a můžeme vybrat konkrétního pochůzkáře. Pokud je vybrán proces, je zviditelněna položka „Automatické zpracování“, která je implicitně zaškrtnuta, tedy spuštěný proces proběhne automaticky. Odškrtnutím lze nastavit manuální zpracování procesu.2 V dalším poli je vypsán výraz, který musí být pravdivý, aby se pravidlo uplatnilo. Prázdný výraz je považován také za pravdivý, z toho plyne, že vyplnění výrazu není povinné a pravidlo pak platí pro všechny případy, kdy nastane vybraná událost. (Např. Pochůzkový bod nenavštíven včas – s prázdným výrazem, pak pravidlo platí, kdykoli je jakýkoli bod jakékoli pochůzky nenavštíven včas.) K sestavení výrazu slouží „Sestavovač výrazu“ ve spodní části okna. Vytváření výrazu je popsané ve zvláštní kapitole 3.2.1.1. K ukončení vytváření pravidla slouží dvě tlačítka nad sestavovačem výrazu. Stiskem tlačítka Uložit dojde k uložení nového pravidla do seznamu pravidel pro daný typ události, stiskem tlačítka Zrušit se vrátíme do seznamu pravidel bez uložení.
1
Proces lze vybrat pouze v případě, že je implementován „Svolávací systém“.
2
Odstavec platí pro případ implementovaného „Svolávacího systému“.
466C008.624.00.N00
9
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
obr. 3-8 Formulář pro vytvoření pravidla
3.2.1.1 Sestavení výrazu V sestavovači výrazů se konečný výraz skládá z jednotlivých útržků, které jsou generovány po výběru jména pochůzky nebo zdrojového nebo cílového bodu a následném kliknutí na příslušné tlačítko Generuj útržek. Například budeme chtít definovat výraz, který určuje, že pravidlo reagující na událost „Pochůzkový bod nenavštíven včas“, platí pouze pro „Standardní pochůzku“ pro zdrojový bod 1 a cílový bod 2. V tom případě (obr. 3-9) vybereme v menu Jméno pochůzky „Standardní pochůzka“ a klikneme na tlačítko „Generuj útržek: zdroj události je pochůzka“. Vygenerovaný útržek je vypsán v prvním řádku Sestavovače výrazu. Pod tímto řádkem jsou umístěna tři tlačítka, která umožňují různým způsobem přidat vygenerovaný útržek do výrazu. Poslední tlačítko slouží pro smazání výrazu. Stiskneme tlačítko „Připojit útržek spojkou AND k výrazu“ a útržek je vypsán v poli pro výraz. Analogickým postupem přidáme do výrazu zdrojový a cílový bod, kterých se má pravidlo týkat.
466C008.624.00.N00
10
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
Útržek připojený do výrazu
Zobrazený vygenerovaný útržek
obr. 3-9 Vytváření výrazu pro pravidlo
3.2.1.2 Časové omezení pravidel Platnost každého pravidla může mít různá časové omezení, např. omezení platnosti v určité: • období (např. od 1.1.2013 do 31.12.2013) • hodiny (např. od 8:00 do 18:00) • minuty (např. každou hodinu, ale jen prvních 15 min) • den v týdnu (např. každý Čtvrtek) • den (např. 3. den) v měsíci • měsíc (např. jen v Lednu) Pravidlo platí od stanoveného data Pravidlo platí do 12:00 Pravidlo platí do od 10. minuty
Pravidlo platí určitý den v měsíci
Pravidlo platí v Lednu
obr. 3-10 Časové omezení pravidel
Dále se potupuje v sestavování výrazu obdobně jako v bodě 3.2.1.1.
466C008.624.00.N00
11
Administrátorský manuál
TTC TELEKOMUNIKACE, s.r.o.
Pravidla a plánování
3.2.2 Editace pravidel Na obr. 3-11 je příklad seznamu pravidel. V pravém sloupci je tlačítko pro editaci daného pravidla. Po jeho stisku se otevře formulář, viz obr. 3-8, kde jsou ovšem vypsány příslušné údaje. Po editaci můžeme změny uložit, nebo tlačítkem Zrušit se lze vrátit zpět na seznam bez uložení provedených změn.
3.2.1 Odstranění pravidla a změna pořadí pravidel V seznamu pravidel je možné řádek označit kliknutím a řádek se poté zvýrazní, viz obr. 3-11. Zároveň se zviditelní tlačítka Dolů a/nebo Nahoru a tlačítko Odstranit. Kliknutím na tlačítka Dolů nebo Nahoru můžeme měnit pořadí pravidel v daném seznamu. Pro odstranění označeného pravidla klikneme na tlačítko Odstranit a po potvrzení (analogicky jako na obr. 3-5) dojde k odstranění označeného řádku.
Tlačítka pro změnu pořadí pravidel v seznamu
obr. 3-11 Seznam pravidel
4 Odkazy [1] Online pochůzkový system - 466C008.610.00 Uživatelský manuál. [2] http://download.oracle.com/otndocs/jcp/ejb-3.1-mrel-evalu-oth-JSpec [3] Svolávací systém - 466C009.610.00 Uživatelský manuál. [4] Svolávací systém - 466C009.624.00 Administrátorský manuál. [5] Dohledový systém - 466C010.610.00 Uživatelský manuál.
466C008.624.00.N00
12
Administrátorský manuál