Naplánované úlohy a autoserver

Naplánované úlohy

Autoserver

V rámci systému ABRA Gen je možno využívat možnosti spouštění některých úloh automaticky bez dalšího zásahu uživatele. K nastavení úloh, které se mají spouštět automaticky a v pravidelných intervalech slouží agenda Naplánované úlohy. Příklady použití - odložení tisku časově náročného reportu na čas po pracovní době, opakované provádění skriptovacích funkcí, opakované spouštění uzávěrek, automatické generování upomínek, plánované spuštění zálohování, spuštění externích programů, stahování e-mailů apod. Nové úlohy lze zadat zde nebo z jiných částí systému (viz funkce Naplánovat v některých agendách).

Automatické spouštění naplánovaných úloh provádí Automatizační server.

Platí:

  • Automatizační server (AutoServer.exe/AutoServerS.exe) musí být nastaven a spuštěn.
  • Automatizační server může běžet na jiném počítači, než na kterém běží Aplikační server nebo na kterém je instalován systém ABRA Gen. Může běžet pouze na OS Windows.
  • Konfigurace automatizačního serveru:
    • 1. část - povinná - viz agenda Nastavení automatizačního serveru
    • 2. část - nepovinná - pomocí souboru AutoServer.cfg. Viz šablona ..\Doc\autoserver\AutoServer.cfg.tmpl.
  • Logování - průběh akcí autoserveru lze logovat. Nastavení logování viz soubor Nexus.cfg→sekce [AS~Group].

Dále naleznete popis podrobněji:

Tato oblast zastřešuje několik typů úloh. Některé z nich jsou provozovatelné samostatně, nicméně spolu souvisí, jak plyne z následujícího popisu:

Systém ABRA Gen umožňuje automatické spouštění úloh různého typu. To uživatel využije typicky pro úlohy, které potřebuje provádět v pravidelných intervalech, ale nechce na jejich provádění myslet nebo se jím zdržovat. (Např. vygenerování žádostí o platební příkazy podle definice opakovaných plateb). Může se jednat i o úlohu, která je časově náročná pro systém a jejíž spouštění je vhodné odložit na dobu, kdy v systému nepracují uživatelé. (Např. automatické spuštění skladové uzávěrky v noci, automatické spuštění zálohy dat apod.). Uživatel může také požadovat pravidelné zasílání vybraných reportů. (Např. automatické vytvoření vybrané tiskové sestavy a její odeslání uživateli na zadané e-mailové adresy a to buď externí e-mailové adresy nebo i jako přílohu tzv. ABRA vzkazu (jedna z možností využití tzv. interního messagingu). Pokud uživatel využívá interního e-mailového klienta a pracuje s odeslanými a došlými e-maily přímo uvnitř ABRA Gen, tak automatické odesílání a stahování e-mailové pošty jsou dalšími z možných plánovaných automaticky spuštěných úloh. Podobnou úlohou může být i informativní automatické zasílání ABRA vzkazů na základě splnění nějakého kontrolního bodu, (uživatel např. požaduje, aby mu systém poslal vzkaz v okamžiku, kdy dojde k zaplacení nějaké faktury), což je další z možností využití interního messagingu. Podrobněji viz Interní messaging, e-mailová komunikace a naplánované úlohy.

Uživatel dále může používat elektronickou fakturaci a může chtít doručené elektronické dokumenty automaticky zpracovat do systému, tj. automaticky z nich založit záznamy do agendy Dokumenty (podrobněji viz Dokumenty - obecně - možnosti založení dokumentu, příp. Zpracování doručených e-mailů a Zpracování front souborů) a tyto dokumenty dále zpracovat, tj. v tomto případě z nich např. vytvořit doklady do příslušných agend (viz Zpracování dokumentů). Automatické zpracování dokumentů ale uživatel využije nejen u dokumentů přijatých, ale zrovna tak vydaných (např. odeslání odběrateli, přes VREP apod.). Automaticky spouštěné úlohy však nemusí být omezeny pouze na funkcionalitu ABRA Gen dodávanou výrobcem, ale může se jednat o pravidelné spouštění nějaké funkce skriptování, které výrazně rozšiřuje možnosti systému (viz možnosti zákaznické modifikovatelnosti systému). Podrobněji viz jednotlivé typy naplánovaných úloh.

Automaticky spouštěné úlohy se definují v agendě Naplánované úlohy. Lze je ale zadávat i z různých jiných částí systému pomocí funkce Naplánovat a Průvodce naplánováním automatického spuštění.

Spuštění a provádění těchto naplánovaných úloh zajišťuje tzv. automatizační server.

O provedených automatických úlohách může chtít uživatel zasílat nějakou zprávu, že daná úloha proběhla a s jakým výsledkem. K zasílání takových informačních vzkazů příp. e-mailů je opět využíván interní messaging. O zaslání takové informační zprávy se opět postará automatizační server v rámci spuštění a zpracování dané naplánované úlohy.

Tedy, aby probíhalo automatické spouštění nějaké akce popsané výše, musí být spuštěn a nakonfigurován Automatizační server a musí být nadefinována a pravidelně spouštěna plánovaná úloha příslušného typu.

Některé z možností využití objasníme na příkladech:

Automatické spouštění úlohy - Uzávěrka skladu s oceněním skladových zásob:

Vedoucí skladu má za úkol pravidelně zajišťovat spouštění skladové uzávěrky, aby byly skladové pohyby oceněny skladovými cenami. Nadefinuje si naplánovanou úlohu typu Uzávěrka skladu s prováděním na noc a s tím, že mu AutoServer má zaslat zprávu po dokončení úlohy. Jakmile nastane okamžik spuštění, AutoServer uzávěrku na zadaných skladech provede a po dokončení zašle uživateli (vedoucímu skladu) vzkaz. Když se druhý den vedoucí skladu přihlásí do systému, obdrží informaci, že má nedoručené vzkazy a může se hned informovat po výsledku úlohy.

Interní messaging - automaticky vytvořený a zaslaný vzkaz na základě nějaké podmínky:

Obchodního ředitele zajímají pohledávky. Chce být informován, pokud je vystavena faktura větší než nějaká hraniční částka. Zadá si tedy kontrolní bod s vazbou na agendu faktur vydaných a definici automatického vzkazu, s výrazem, že částka v lokální měně je větší nebo rovna např. 50000. Dále musí být nadefinována naplánovaná úloha typu Automatické vzkazy, spuštěn a nakonfigurován AutoServer. Pak jakmile někdo vystaví fakturu vydanou na částku vyšší, systém vygeneruje požadavek na zaslání vzkazu obchodnímu řediteli a při dalším cyklu spuštění naplánované úlohy pro zasílání automatických vzkazů daný vzkaz pro uživatele - obchodního ředitele vytvoří a doručí mu o něm oznámení.

Interní messaging - automaticky vytvořený a zaslaný vzkaz na základě nějaké podmínky:

Obchodník chce být informován o zaplacení faktury odběratelem, aby mohl zajistit další část sjednané zakázky. Využije systémově dodávaný kontrolní bod Zaplacení dokladu s vazbou na agendu faktur vydaných a zadá si definici automatického vzkazu s vazbou na sledovanou fakturu. Dále musí být nadefinována naplánovaná úloha typu Automatické vzkazy, spuštěn a nakonfigurován AutoServer. Pak jakmile dojde k nové platbě uvedené faktury, systém vygeneruje požadavek na zaslání vzkazu uživateli - obchodníkovi a při dalším cyklu spuštění naplánované úlohy pro zasílání automatických vzkazů daný vzkaz pro obchodníka vytvoří a doručí mu o něm oznámení.

Automatické spouštění úlohy - Upozornění na servisovaný předmět:

V modulu Servis se vyberou servisované předměty vyhovující omezení zadanému v naplánované úloze tohoto typu, např. auta, u nichž brzo nastane datum příští kontroly. Vytvoří se o tom e-mail a zašle se provozovateli daného vozidla. Vedoucí servisu si o provedení napl. úlohy může nechat poslat vzkaz nebo e-mail na svůj vlastní mail, aby měl jistotu, že úloha probíhá správně.

Výše uvedené dokresluje následující schématický obrázek:

Schéma naznačuje možnosti využití autoserveru pro různé typy úloh, přičemž více rozvádí využití v interním messagingu

V této části naleznete princip ABRA automatizačního serveru, informace, jak jej zprovoznit, nakonfigurovat a další rady s ním související. Na úvod se můžete podívat na krátké výukové video.

Naplánované úlohy, 1. část: Nastavení automatizačního serveru

Ve verzi 21.1 byl změněn celkový vzhled systému, na některých místech došlo k úpravám uspořádání uživatelského rozhraní. Vzhled produktu zachycený na obrázku/ve videu se proto může od aktuální verze mírně lišit. Bez ohledu na vizuální rozdíly obrázky/videa stále relevantním způsobem osvětlují danou problematiku.Více viz Obrázky a videa v helpu.

Automatizační server může být realizován více způsoby:

  • AutoServerS.exe - Automatizačním serverem je Windows služba (service). Doporučeno.
  • AutoServer.exe - Automatizačním serverem je Windows aplikace (exe).

Chová se jako klientská část aplikace ABRA Gen, která komunikuje s aplikačním serverem (tedy obdobně jako jakýkoliv jiný klient ABRA Gen). (Pojem klientská část viz kap. Technologie zpracování dat.)

Jeho použití je omezeno na operační systém MS Windows. Jedná se o klientskou část aplikace ABRA Gen, tedy i když máte síťovou část instalace na Linuxu a chtěli byste využívat automatizační server, je třeba počítat s tím, že automatizační server musí běžet na některém z windowsových klientů.

Registrace (spuštění) a další podmínky spuštění (UNC cesty vs. mapované disky atd.)

AutoServer.exe se spustí standardním způsobem jako exe soubor, pak, je-li spuštěn, je na toolbaru zobrazena ikona s možností zobrazit si seznam spojení na databázi, které automatizační server zpracovává s informací, zda je pro dané spojení server aktivní (viz příznak Aktivní v Nastavení automatizačního serveru).

AutoServerS.exe je Windows služba, která vykonává vše potřebné v systému ABRA Gen. Pro provoz automatizačního serveru jako služby je nejprve nutné tuto službu nainstalovat resp. zaregistrovat spuštěním dodávaného exe souboru z příkazové řádky (k tomu je třeba mít administrátorský přístup). Tj. pod administrátorským účtem nainstalovat servis z příkazové řádky jeho zavoláním s parametrem /INSTALL (resp. -INSTALL) z adresáře, kde je automatizační server umístěn:

<cesta>\AutoServerS.exe /INSTALL

Pro odinstalaci totéž ale s parametrem /UNINSTALL (resp. -UNINSTALL).

  • Automatizační server může běžet na jiném počítači, než kde běží aplikační server a než kde je instalován systém ABRA Gen. To bude typický případ v praxi (kvůli rozdělení zátěže).

    Aplikační server běží na jednom počítači, automatizační server na jiném počítači, přičemž fyzicky leží na třetím počítači v adresáři, kde je ABRA nainstalována.

    V takovém případě se AutoServerS.exe musí instalovat s UNC cestou (ne z namapované cesty). Tedy např. \\GxAppServer\AbraGen\AutoServerS -install. Instalace s cestou zadanou přes mapovaný disk, tj. např. W:\AbraGen\AutoServerS -install sice půjde nainstalovat, ale nepůjde spustit. Je to z toho důvodu, že služba neběží pod profilem aktuálně přihlášeného uživatele. Nemá jeho prostředí (plochu, různá nastavení atd. a mimo jiné ani mapování síťové cesty \\GxAppServer\AbraGen\ na písmenko W).

Automatizační server je realizován tak, že je bezúdržbový, tj. pro zdárné provozování automaticky spouštěných úloh jej stačí spustit, dále se o spouštění úloh stará sám. Ztratí-li automatizační server spojení na aplikační server, není nutné program, případně službu zastavovat. Automatizační server vyčkává (sám se nijak násilně neukončí, maximálně "odpadnou" právě probíhající procesy ("slaves"), které zpracovávají naplánované úlohy) a v krátkých intervalech zkouší komunikaci obnovit. Po znovunavázání spojení pokračuje aplikační server v práci normálně, tj. zkontroluje, zda jsou nějaké úlohy ke spuštění a spustí si odpovídající počet procesů ("slaves"). Při restartu aplikačního serveru je však nutné automatizační server restartovat také, jinak ho systém nebude schopný najít.

Logování

O průběhu akcí autoserveru resp. jeho slavů (viz dále) si můžeme zobrazit log. Logování událostí v automatizačním serveru se konfiguruje jako ostatní logování v konfiguračním souboru Nexus.cfg v sekci [AS~Group]. Konfigurační soubor Nexus.cfg systém hledá ve stejné cestě, jako je AbraGen.exe.

[Log.AS~Group]
Enabled=1
Level=6

Jelikož AS server je nevizuální, je v případě potíží potřeba logovat vícero věcí a logování týkající se autoserveru tudíž probíhá více třídami. Jejich vzájemná konfigurace může být složitá, navíc logování jen jedné z nich může být v praxi pro odhalení problému nedostatečné, nebude-li k dispozici současně i log jiné z nich. Proto je k dispozici logovací skupina AS~Group. Zapnout "rozumné" logování je možné přidáním právě této skupiny do Nexus.cfg. Pozor, bude vznikat množství log souborů, které je nutné rozumně odsouvat.

Tisky/exporty prostřednictvím automatizačního serveru

V praxi automatizační server většinou poběží na jiném počítači než na uživatelském PC. Buď na serveru, kde běží aplikační server, nebo na úplně jiném serveru a pod "nějakým" jiným uživatelem. To způsobuje, že např. nejsou namapované diskové jednotky, nicméně UNC cesty fungují bez problémů. Viz též Registrace, další podmínky spuštění (UNC cesty vs. mapované disky atd.). Dále tzn., že nastavení tiskáren (ovladačů) bude jiné, než má uživatel. Platí:

  • AutoServer instalovaný jako služba běží pod místním systémovým účtem. Dále služba běží pod nějakým účtem Windows a to může způsobit, že do vybrané složky nepůjde zapisovat (omezení pro případ exportu do souboru, případně uložení tiskové sestavy do souboru). Toto omezení platí jak pro lokální disky tak i UNC cesty.
  • AutoServer využívá k tisku vždy ovladač defaultní tiskárny uživatele, pod kterým služba běží.
  • Místní systémový účet nemusí mít žádnou defaultní tiskárnu nastavenu (není známo, jak ji nastavit, lze-li to).

Z toho plyne, že pro zprovoznění AutoServeru je doporučeno: Po instalaci službě nastavit, že se má přihlašovat jako nějaký uživatel serveru, pod jehož účtem je možné se přihlásit a provést mu nastavení vhodné defaultní tiskárny. Pozor, grafický výstup tisku bude odpovídat ovladači serverové tiskárny a nikoli ovladači tiskárny uživatelského PC.

Konfigurace autoserveru se skládá ze dvou částí:

  • První, povinná část - viz agenda Nastavení automatizačního serveru.

  • Druhá, nepovinná část - pomocí souboru AutoServer.cfg. Je možné pomocí něj např. nastavit, pro jaká spojení na databázi má autoserver běžící na daném počítači spouštět naplánované úlohy. Využijete tehdy, pokud máte velký počet spojení, kdy nemusí jeden počítač stačit. Konfigurační soubor je periodicky načítán. Není povinný. Není-li soubor vytvořen, automatizační server si stáhne seznam všech existujících spojení a jejich naplánované úlohy začne normálně zpracovávat.

    V instalačním adresáři ABRA Gen je v podadresáři ..\Doc\autoserver šablona konfiguračního souboru, která slouží ke konfiguraci autoserveru.

    Šablonu konfiguračního souboru je nutné přejmenovat (resp. odstranit koncovku tmpl) a nakopírovat do příslušného adresáře a případně ji dle potřeby upravit. Soubor musí být umístěn ve stejném adresáři jako program AutoServer.exe nebo služba AutoServerS.exe. Konfigurační soubor obsahuje sekce [AutoServer] a [AutoServerSlave], které dále obsahují parametry, jež jsou v základním stavu okomentovány (je před nimi uveden znak #) a v tomto stavu se přebírá vyplněná výchozí hodnota parametru. Pokud je daný parametr nutno změnit, je třeba znak # odstranit.

    AutoServer.cfg.tmpl obsahuje tyto parametry:

      Název Popis
    Sekce [AutoServer]  
      CreateProcessTimeout Max. doba v ms, po kterou autoserver čeká na odezvu od slave procesu. AutoServer kontroluje, zda slave proces nabíhá ve stanoveném času. Výchozí hodnota je 20000.
      Connection

    Výčet spojení na databázi, pro která se má spouštět AutoserverSlave.

    U instalací s velkým počtem spojení nastává situace, že je AutoServer využíván jen v jednom či dvou z nich a pro všechna ostatní (např. dalších 15 spojení) se Slave spouští zbytečně, což způsobuje, že zbytečně zabírá paměť a prodlužuje start AutoServeru.

    Automatizační server může obsluhovat maximálně 64 spojení.
      ShowTryIcon Možnost povolit/zakázat zobrazování ikony pro AutoServer.exe v tray oblasti.
      ForcedReleaseProxy

    Možnost ukončit proces AutoServerSlave vždy po vykonání jednotlivého úkolu. Pro nový úkol je pak automaticky spouštěn znovu.

    Není doporučeno běžně používat. Zpomaluje vykonání úkolů.
    Sekce [AutoServerSlave]  
      ShowTryIcon Možnost povolit/zakázat zobrazování ikony pro AutoServerSlave.exe v tray oblasti.
      MaxUsedMemory Max. paměť pro slave proces. Pokud, slave proces paměť přesáhne, je ukončen a po čase jeho místo zaujme nový. Výchozí hodnota je 384MB.

    [AutoServer]
    Connection=FirmaA
    Connection1=FirmaB
    Connection2=Demodata
    ShowTryIcon=1

    [AutoServerSlave]
    ShowTryIcon=1

    Podle tohoto příkladu bude takto nakonfigurovaný automatizační server pracovat pouze pro spojení se jmény FirmaA, FirmaB a Demodata.

    [AutoServer]
    CreateProcessTimeout=60000

    Můžete využít např. v případě instalace s větším množstvím spojení na slabším HW, kdy nabíhající slave proces nestačí do stanovené doby poslat informaci automatizačnímu serveru o svém naběhnutí. Automatizační server tudíž takový slave proces ukončí a spustí jej znovu (nový slave proces). Řešením je prodloužit dobu, po kterou automatizační server čeká na odezvu od slave procesu podle příkladu výše.

Automatizační server AutoServer.exe resp. AutoServerS.exe je jen jakási "obálka", která zajišťuje spouštění procesů pro jednotlivé naplánované úlohy. Každou takovou úlohu vykonává tzv. "slave" automatizačního serveru AutoServerSlave.exe. Tedy samotný server nevykonává úlohy, ale pouze přijímá požadavky na jejich spuštění a řadí je do fronty spuštěných úloh, odkud je vyzvedávají "slavy" a provádí je. Každý "slave" dokáže vykonávat najednou pouze jednu úlohu, což v podstatě znamená, že počet právě spuštěných "slavů" se rovná max. počtu současně vyřizovaných úloh (vždy však běží minimálně jeden, který autom. server využívá na svou vlastní komunikaci s aplikačním serverem).

Autoserver a více spojení na databázi: Pozor, pokud máte víc spojení na databázi, pak platí, že automatizační server zpracovává současně všechna. Tedy pro každé z nich běží nějaké procesy. Tzn., že po spuštění automatizačního serveru např. pro dvě spojení, běží minimálně dva procesy, které autom. server využívá na svou vlastní komunikaci s aplikačním serverem.

Maximální počet současně běžících "slavů" (tj. současně běžících úloh) lze nastavit v Nastavení automatizačního serveru (pro každé spojení zvlášť). Více se limity automatizačního serveru a jeho nastavím pro více jak 20 spojení zabýváme v samostatné kapitole Limity automatizačního serveru.

Uživatel sám nijak AutoServerSlave.exe nespouští. Aplikační server si tyto své "slavy" spouští a ukončuje automaticky sám podle toho, jak potřebuje. Např. pokud se spuštění více naplánovaných úloh časově překrývá, spustí si automatizační server pro každou z nich další "slave" proces. Přitom ale jeden z běžících procesů využívá i na svou komunikaci s aplikačním serverem. Proto pokud je naplánovaná úloha jen jedna, ale je časově náročná a autom. server potřebuje v daném intervalu komunikovat, spustí si další slave proces pro svou komunikaci.

Pozor! Podmínky rozběhnutí autoserveru pro dané spojení: Automatizační server si z repozitoře čte seznam spojení (s ohledem na interval v Nastavení automatizačního serveru). Přitom u každého spojení sleduje aktuální stav spojení. Rozjede se pouze pro spojení, které je ve stavu OK, resp. případně již běžící procesy pro toto spojení ukončí, pokud tomu tak není.

Nezbytnou podmínkou pro provoz autoserveru a spouštění naplánovaných úloh je, aby byla tato část systému nainstalována a licencována.

Dále se při inicializaci kontroluje:

Jak plyne z textu výše, pro provoz automatizačního serveru je dále třeba:

  • Mít správně provedenou konfiguraci automatizačního serveru

  • Zajistit běh automatizačního serveru a jeho komunikaci s aplikačním serverem, tj.:

    • mít nainstalovanou službu Auto serveru a mít ji spuštěnu (pokud jej provozujete jako službu (doporučeno)),
    • nebo mít spuštěnou aplikaci (pokud jej provozujete jako Win aplikaci),
    • zajistit spuštění aplikačního serveru (aplikační server se ale umí spustit i automaticky v případě instalace na stejném PC, z kterého se spustí klientská část ABRA Gen (zde automatizační server)).

Systém ABRA Gen by měl být nainstalován jako síťový (tj. s aplikačním serverem). (Automatizační server je klientem aplikačního serveru, jak bylo řečeno výše, a tudíž po jeho spuštění není možné již spustit systém ABRA Gen nainstalovaný jako single a naopak (systém nahlásí pokus o opakované spuštění stejné jednouživatelské verze)).

Přístupová práva - pokud se v rámci nějaké naplánované úlohy pracuje s chráněnými objekty (např. se vytváří doklad v nějaké řadě, zpracovává se dokument určité kategorie), je to možné jenom pro ty chráněné objekty, ke kterým má uživatel, pod nímž se daná akce provádí, přístupové právo (viz práva Zobrazit, Použít, Provést/zrušit uzávěrku skladu, Zpracovat,... pro jednotlivé typy chráněných objektů).

Dále se v rámci naplánovaných úloh může pracovat s e-mailovými účty. Nejde pouze o úlohy pro samotné automatické stahování e-mailů či automatické odesílání existujících e-mailů ve stavu "K odeslání", ale i o všechny ostatní naplánované úlohy. Jelikož jak bylo zmíněno výše, součástí každé úlohy může být odesílání zpráv po dokončení úlohy (vzkazů a odeslaných e-mailů přes e-mailové účty v systému ABRA) zadaným adresátům (viz subzáložka Odeslat zprávu po dokončení úlohy). Také mohou existovat úlohy, kde vytvoření e-mailu nějakému konkrétnímu adresátovi je cílem dané úlohy, aniž by šlo o e-mail odesílaný po dokončení úlohy (viz např. úloha typu Upozornění na servisovaný předmět (v rámci ní mohou totiž vznikat dva typy e-mailů a to jednak e-mail provozovateli s daným upozorněním a jednak e-mail zvoleným adresátům v rámci zpráv po dokončení úlohy o tom, že úloha proběhla/neproběhla)).

E-mailové účty a Účty odchozího serveru SMTP jsou jedním z chráněných objektů. Platí: E-maily je možné posílat a stahovat jenom z těch účtů, ke kterým je přístupové právo. To je v případě e-mailů posílaných či stahovaných v rámci naplánovaných úloh dáno právy uživatele (resp. jeho role), pod kterým se daná akce má provést:

Dále tento uživatel musí mít dostatečná přístupová práva k řadám dokladů a ke středisku zadaným v definici daného e-mailového účtu, jelikož se jedná rovněž o chráněné objekty. (Aby bylo možné generovat záznamy odeslaných a doručených e-mailů přes daný e-mailový účet.)

Pokud k účtu nemá daný uživatel přístupové právo, úloha se neprovede a skončí s chybou.

Z výše uvedeného plyne: Aby bylo možné generovat odeslané a doručené e-maily přes daný účet, musí být použit takový e-mailový účet z agendy E-mailové účty, ke kterému má uživatel právo.