====== Plánovač úloh ======

Plánovač úloh je prostředek, pomocí kterého lze plánovat **periodické spouštění vybraných úloh** Orsoftu Open.

Podle vybraného typu úlohy se může jednat o **kontroly termínů** (blížících se nebo vypršených), kontrolu datumů platnosti nebo účinnosti apod. Lze též plánovat pravidelné **spouštění dávek** (např. stahování kurzů, aktualizaci insolvenčního rejstříku apod.).

Pro úlohy, jejichž výstupem je typicky seznam záznamů vyhovujících zadaným podmínkám, lze naplánovat **automatické odeslání výstupů na e-mail**.

Veškerá spuštění úloh včetně výsledků jsou zdokumentována v **historii**.

Plánovač je rozdělen na definiční část (záložka **Základní údaje**) a historii (záložka **Historie**)

**Základní údaje** obsahují tyto položky. Sekce //**Plán spuštění** //, //**Úloha** // a //**Výsledek** // jsou shodné pro všechny úlohy, kdežto //**Parametry úlohy** // se mohou obsahově lišit dle typu úlohy:

{{:orsoftopen:o0:task:o0taskplan1.png?direct&}}

  * **Plán spuštění**  - definice časů a intervalů spuštění, povolení spuštění
      * **Typ**  - typ spuštění
        * **//Denně//**  - úloha se bude spouštět každý den ve stanovený čas
        * **//Vybrané dny v týdnu//**  - úloha se bude spouštět ve vybraných dnech v týdnu (Po, Út, St, Čt, Pá, So, Ne). Dny se definují zaškrtnutím.
        * **//Vybrané dny v měsíci//**  - úloha se bude spouštět ve vybraných dnech v měsíci (1. až 31. a posledního). Dny se definují zaškrtnutím.
      * **Čas**  - čas spuštění úlohy (hodina a minuta)
      * **Opakování**  - možnost definovat, že úloha se bude spouštět vícekrát za den, tj. opakovaně po vybraném počtu minut nebo hodin. Očekává se, že uživatel vyplní buď parametr //Čas//  nebo parametr //Opakování//. Pokud by vyplnil oboje, tak opakování začne podle zadaného začátku a skončí před půlnocí. Takže např. začátek = 6:00, opakování = 10 minut – poprvé se úloha v tento spustí v 6:00, pak v 6:10, naposledy v 23:50, pak až následující den v 6:00.
      * **Povoleno**  - pokud je zaškrtnuto, úloha se bude spouštět dle plánu. Pokud zaškrtnuto není, lze úlohu spustit pouze ručně, což může být potřeba pro odzkoušení. Ruční spuštění úlohy lze provést z horní ikonové lišty volbou //**Nabídka/Spustit úlohu**//  . Pokud se po spuštění objeví hláška "… Plánovač úloh není aktivní, zkontrolujte konfiguraci plánovače", je potřeba ve volbě //**Nabídka/Nastavení**//  vyplnit login, pod kterým se budou úlohy spouštět.
      * **Příští spuštění**  - příští nejbližší datum a čas spuštění vypočtený z aktuálního data a nastaveného plánu.
{{:orsoftopen:o0:task:o0taskuloha1.png?direct&}}

  * **Úloha**  - definice úlohy
      * **Úloha**  - zde se definuje typ úlohy, která se bude plánovat. Vybírá se z předvyplněných hodnot, které jsou definované v číselníku O0TASK (Lze prohlížet ve volbě //Kmenová data/Parametry/Číselníky/Správa číselníků/O0TASK//).
        * **Číselník O0TASK**  - obsahuje typy úloh připravené dodavatelem. K názvu úlohy je přiřazen program (třída), který vlastní úlohu provádí. Podporované typy úloh:
          * **D*** - úlohy pro [[:orsoftopen:d0:task:d0task|specifické kontroly v Personalistice]] (např. kontrola platnosti školení)
          * **[[:orsoftopen:o0:task:o0task:oxupozterm|OxUpozTerm]]** - obecná úloha pro kontrolu termínů v entitě. Konkrétní kontrola je určena v parametrech úlohy. Podrobněji **[[:orsoftopen:o0:task:o0task:oxupozterm|zde]]**.
          * **[[:orsoftopen:o0:task:o0task:oxspustdav|OxSpustdav]]**- obecná úloha pro spouštění dávek (např. stahování kurzovního lístku, doplnění insolvenčního rejstříku apod.). Konkrétní akce je určena v parametrech úlohy. Podrobněji **[[:orsoftopen:o0:task:o0task:oxspustdav|zde]]**.
          * **[[:orsoftopen:o0:task:o0task:oxjasperdav|OxJasperdav]]**- obecná úloha pro tisk dle sestavy v Jasperu. Konkrétní chování tisku lze určit v parametrech úlohy. Podrobněji **[[:orsoftopen:o0:task:o0task:oxjasperdav|zde]]**.
      * **Název úlohy**  - zde se vyplní název konkrétního použití úlohy, který si volí uživatel. Názvem lze rozlišit konkrétní určení plánované úlohy, kdy jedna úloha (z O0TASK) může v závislosti na parametrech provádět různé akce. Názvy úloh by měly být unikátní. **Vzorové úlohy**  (viz detailněji níže) mají //Název úlohy//  začínající na "=VZOR=" nebo "=VZOR-ORCZ=".
      * **Popis**  - tlačítko pro zobrazení detailního popisu úlohy. Tento popis je k dispozici uživateli pro poznámky. U vzorových úloh v něm může být komentář k funkci a možným parametrům úlohy.
{{:orsoftopen:o0:task:o0taskpard.png?direct&}}

  * **Parametry úlohy**  - specifické parametry pro daný typ úlohy (popis pro pro úlohy **D* Personalistiky**  (obr. nahoře), ostatní úlohy zde **[[:orsoftopen:o0:task:o0task:oxupozterm|OxUpozTerm]]**, **[[:orsoftopen:o0:task:o0task:oxspustdav|OxSpustdav]]**, **[[:orsoftopen:o0:task:o0task:oxjasperdav|OxJasperdav]]**)
      * **Kontrolovat Od: Měsíců a dnů**  - počet měsíců a/nebo dnů "od" vzhledem k datu spuštění (pro kontrolu datumu v záznamu), tj. doba kontroly zpět. Je-li 0 (nula), kontroluje se od data spuštění. Je-li nevyplněno, kontroluje se vše minulé.
      * **Kontrolovat Do: Měsíců a dnů**  - počet měsíců a/nebo dnů "do" vzhledem k datu spuštění (pro kontrolu datumu v záznamu), tj. doba kontroly dopředu. Je-li 0 (nula), kontroluje se do data spuštění. Je-li nevyplněno, kontroluje se vše budoucí.
      * **Dle plánu od**  - datum a čas od vypočtený z plánu a hodnoty Kontrolovat Od. Záznamy se filtrují od tohoto data.
      * **Dle plánu do**  - datum a čas do vypočtený z plánu a hodnoty Kontrolovat Do. Záznamy se filtrují do tohoto data.
      * **Podmínka výběru zaměstnance**  - další podmínka výběru (kromě datumu výše) v syntaxi HQL
      * **Třídění seznamu zaměstnanců**  - volba setřídění výsledku (seznamu zaměstnanců) - dle osobního čísla nebo dle příjmení a jména
{{:orsoftopen:o0:task:o0taskvysledek.png?direct&}}

  * **Výsledek**  - práce s výsledkem úlohy. Spuštění úlohy může vytvářet tzv. výsledek, což bývá často např. seznam záznamů (např. smlouvy s prošlým termínem platnosti apod.) nalezených při kontrole termínů. Obsah výsledku vytváří buď program spojený s úlohou nebo jej lze pro některé úlohy definovat v parametrech úlohy.
      * **Vzor e-mailu**  - název šablony mailu, v němž se odešle celkový výsledek úlohy. Šablona se vybírá ze seznamu šablon. Uživatel si může definovat a upravovat vlastní šablony ve volbě //Administrace/Parametry/Plánovač úloh/Šablony mailů//.
      * **E-mail**  - souhrnný e-mail, na který se odešle celkový výsledek úlohy. Může být i více mailů oddělených čárkou. Pokud není vyplněn, tak se mail neodesílá.
      * **Workflow - typ**  - typ workflow navázaný na úlohu
-

**Další nabídka**  - obsahuje tyto volby

  * **Spustit úlohu**  - okamžité ruční spuštění úlohy, bez ohledu na plán. Pokud se po spuštění objeví hláška "… Plánovač úloh není aktivní, zkontrolujte konfiguraci plánovače", je potřeba ve volbě //**Nabídka/Nastavení**//  vyplnit login, pod kterým se budou úlohy spouštět.
  * **Běžící úlohy**  - zobrazí seznam běžících úloh, které dosud nebyly ukončeny. Zobrazí se název úlohy, způsob spuštění (ručně, dle plánu), kdo spustil (stroj, login, uživatel), plánovaný a skutečný čas spuštění a celková doba běhu úlohy. Lze tak zjistit, zda jsou některé zamrzlé nebo trvají příliš dlouho.
  * **Nastavení**  - zde je nutné vyplnit login, pod kterým se budou úlohy spouštět
{{:orsoftopen:o0:task:o0tasknastaveni.png?direct&}}-

**Historie**  - pro každou naplánovanou úlohu se zaznamenává **historie spouštění**. Zde jsou zaznamenána všechna spuštění automatická (dle plánu) i ruční.

{{:orsoftopen:o0:task:o0taskhistorie.png?direct&}}

Záznam historie obsahuje:

  * **Datum a čas spuštění úlohy**  -
  * **Výsledek - počet záznamů**  - u úloh kontrolujících termíny je to počet nalezených záznamů, které jsou vypsány ve výsledku
  * **Výsledek**  - hodnota výsledku sestavená z jednotlivých řádků. Jeden řádek výsledku odpovídá jednomu nalezenému záznamu.
-

**Zápisy do logu**  - kromě zápisů do historie (viz výše) jsou jednotlivá spuštění úloh logována v logu Orsoftu (O0log). Zaznamenává se spuštění (> Dávka: …) i ukončení úlohy ( < Dávka: …) ve dvou samostatných zápisech. Původ záznamu je "P" (Plánovač úloh). Pokud spuštěná úloha vypisuje také informace do logu, budou se nacházet mezi záznamy o spuštění a ukončení úlohy. Oproti historii se sem zapisují i neúspěšná spuštění a chybové výpisy.

**Vzorové úlohy**  - při plánování úloh lze také využít vzorové úlohy. Vzorové úlohy můžete naimportovat ve volbě //Administrace/Mimořádné akce/Import export/Import//, zde vyberte O0task-VZORY_vzor (příp. též O0task-VZORY-orcz_vzor) a proveďte Přepis. Tím se vzorové úlohy objeví v plánovači. Vyznačují se tím, že mají „Název úlohy“ začínající na „=VZOR=“ (příp. „=VZOR-ORCZ=“). Přes tlačítko //Popis//  lze zobrazit další informace ke vzoru. S využitím těchto vzorů si můžete zkopírováním a úpravou vytvořit vlastní „ostré“ úlohy.

Vzorové úlohy nelze spouštět ani editovat, slouží pouze jako dodavatelem distribuované vzory. Pokud dodavatel upraví aktuální vzory, naimportují se do plánovače automaticky.

Pro vytvoření vlastních** "ostrých" úloh**  je nutné je zkopírovat opisem, upravit název (tj. vypustit řetězec „=VZOR=“ příp. „=VZOR-ORCZ=“ a upravit další část názvu) a nastavit další parametry pro spuštění. Názvy úloh by měly být unikátní.

{{:orsoftopen:o0:task:o0taskvzor.png?direct&}}