Plánování pravidelných příloh - VCZ Task Manager



1 Úvod

Úprava umožňuje snadné uživatelské definování plánovaných úloh, které zajistí automatické pravidelné zasílání reportů v různých formátech (PDF, Word, Excel, CSV atp.) definovatelným příjemcům. Těmi mohou být interní uživatelé (interní SBO zpráva) či externisté (odeslání emailem).

Úprava dále umožňuje nastavení specifických operací, které jsou současně s odesláním reportu provedeny. Specifickou operací může být například založení činnosti do systému, ve které je odeslání reportu zaznamenáno, dále například zablokování karty obchodního partnera, označení faktury že již byla součástí daného reportu atp. Specifické operace mohou být na základě Vašich požadavků rozšiřovány.

2 Ukázkové příklady

2.1 Pravidelný vnitrofiremní reporting

Vedoucí společnosti chce mít každý měsíc souhrnný přehled o vývoji tržeb a zisku, či jiných vnitropodnikových ukazatelích.

 Ukázka nastavení:



 

Odeslaný email obsahuje přiložený PDF soubor s analýzou prodeje:

 

 

2.2 Pravidelný export dat do systémů obchodních partnerů

Mateřská společnost žádá o pravidelný reporting otevřených prodejních zakázek, nákupních objednávek a stav skladových zásob. Data mají být odesílána emailem vždy 1x týdně a souhrnně 1x měsíčně ve specifickém formátu CSV.

Ukázka nastavení:


 

 Odeslaný email včetně příslušných příloh:

 

3 Požadovaná nastavení

3.1 Instalace modulu

Funkcionalita je součástí addonu VRIS. Pro jeho instalaci je zapotřebí zalicencovat a spustit instalaci u RQ1116-00.

 Pro zajištění pravidelného spouštění je zapotřebí nastavit službu zpracovávající naplánované úlohy (nastavení služby není součástí této dokumentace, viz technický popis - TEC1116-00_Plánování_pravidelných_úloh.doc). Pro odesílání emailů je zapotřebí nastavená služba pro maily (SBO Mailer nebo VCZ SBO MAILER).

 Nastavení odesílání a zpracování naplánované úlohy provedete jednoduše ve třech uživatelských tabulkách:

  •  VCZ Plánování úloh „co má být a kdy zpracováno“
  • VCZ Rozdělovník odesílání  „definice příjemců plánované úlohy“
  •  VCZ Nastavení tisku „určení výstupu plánované úlohy“

 

3.2 Plánování úloh

Uživatelská tabulka VCZ_TASK_SETP – VCZ Plánování úloh

Code, Name: libovolný pro jednotlivé řádky neduplicitní údaj

Perioda: zadejte jak často má být daná úloha spouštěna.

Periody spouštění (časové jednotky - minuta, hodina, den, týden, měsíc)

Periody opakování, tj. zadáním po kolika jednotkách času se daná úloha opakuje.

Datum a čas příštího spuštění: nastavte okamžik prvního spuštění, po provedení úlohy systém automaticky tyto pole upraví dle zadané periody

Platné od/do data: nepovinný údaj, platnost definice plánované úlohy

Datum a čas posledního spuštění: nevyplňovat, slouží pro informaci, kdy naposledy byla daná úloha spuštěna

Stav: nevyplňovat, slouží pro informaci jakým způsobem proběhla či probíhá daná úloha

 Plánováno = úloha neproběhla, čeká na zpracování

 Probíhá = zpracování úlohy právě probíhá

 Dokončená úspěšně = dokončena

 Ukončena s chybou = chyba při zpracování, detail viz log

 Typ úlohy:  Plánovaná úloha může odeslat report (volba Report), skupinu reportů (volba Reporty dle modulu) či vykonat specifickou operaci (volba specifická).

První dvě volby mají vazbu do tabulky nastavení tisku, ve které je definován report/reporty, které mají být a v jakém formátu odeslány.

ID úlohy: přiřazení konkrétního reportu či skupiny reportů dané úloze

  •  Při volbě typu úlohy – Report – zadejte hodnotu z pole „Code“ z konkrétního řádku definice tisku v tabulce VCZ_PRINTRPT_SETP
  • Při volbě typu úlohy – Reporty dle modulu – zadejte hodnotu z pole „Modul“ z konkrétních řádků definicí tisku v tabulce VCZ_PRINTRPT_SETP

Parametry úlohy: Slouží pro předání parametrů ke spuštění úlohy (např. parametry reportu).

Možnosti zadání parametrů jsou:

  • Vyjmenováním názvů a hodnot oddělených středníkem: Název_Par1=Hodnota;Název_par2=Hodnota2
  • SQL dotazem – viz popis syntaxe parametrů úlohy

Rozdělovník: Slouží pro určení příjemců dané úlohy. Pokud je úloha typu report, který se má odeslat e-mailem, pak se v poli Rozdělovník zadá „ID rozdělovníku“ z tabulky VCZ Rozdělovník odesílání.

ID specifické operace: V tomto pole lze určit konkrétní algoritmus, který se má vykonat po úspěšném provedení úlohy. ID dostane algoritmus při vývoji. Jejich seznam bude postupně doplněn.

 Např. „BPBLOK“ = zablokování obchodních partnerů


Startovací podmínka: Pokud je třeba podmínit provedení úlohy nějakou další podmínkou, lze ji uvést v poli SQL podmínky spuštění. 

 Zde se uvede SQL dotaz do podnikové databáze, a pokud tento vrátí před spuštěním úlohy nenulový počet řádků, je úloha spuštěna. V opačném případě ke spuštění úlohy nedojde. 

Příklad využití: Report se má odeslat, pouze pokud bude obsahovat nějaká data. Do podmínky spuštění se tedy uvede shodný SQL dotaz se zdrojovým dotazem daného reportu.

Pro složitější specifické podmínky lze využít odkaz na algoritmus (pravidlo), který rozhoduje o provedení či neprovedení. Tento se vyplňuje v poli ID podmínky spuštění. ID dostane algoritmus při vývoji.

 

3.3 Nastavení výstupu

Uživatelská tabulka VCZ_PRINTRPT_SETP – VCZ Nastavení tisku


 

 

Code nebo Modul: vazební údaj do nastavení plánovaných úloh (viz typ úlohy v tabulce VCZ Plánování úloh)

Name: libovolný pro jednotlivé řádky neduplicitní údaj

Podadresář reportu:  adresář, ve kterém je report uložen

Jméno reportu: jméno reportu

Popis reportu:  popis reportu

Export reportu: zaškrtněte, označuje, že daný report bude před odesláním vyexportován dle typu výstupu

Typ výstupu: určete formát, do kterého bude report vyexportován (PDF, Word, Excel, CSV, HTML, RTF)

Odeslání reportu: zaškrtněte

Rozdělovník: slouží pro určení příjemců daného. „ID rozdělovníku“ z tabulky VCZ Rozdělovník odesílání. Není-li tento údaj vyplněn, je rozdělovník určen dle nastavení v tabulce VCZ Plánování úloh.


3.4 Nastavení příjemců

Uživatelská tabulka VCZ_MAIL_LIST – VCZ Rozdělovník odesílání

Tato uživatelská tabulka slouží pro nastavení příjemců jednotlivých. Těmi mohou být interní uživatelé SBO (upozornění prostřednictvím interní zprávy) či externisté (upozornění prostřednictvím emailu).

Přiřazení příjemců probíhá v tabulce VCZ Plánování úloh nebo VCZ Nastavení tisku (viz popis nastavení).

Code: libovolný neduplicitní údaj

Name: libovolný neduplicitní údaj

ID Rozdělovníku: identifikace rozdělovníku, vazba na VCZ Plánování úloh nebo VCZ Nastavení tisku.

Pozn: rozdělovník s jednoznačným ID může být definován i více řádky

Odeslat interně: zpráva odeslána interně

Odeslat Emailem:  zpráva odeslána emailem

Typ adresáta:  určení typu adresáta, možné nastavení:

 

Náhod.

..bude doplněno.. nepoužívat

Kont.osoba

..bude doplněno.. nepoužívat

Int.uživatel

adresát je interním uživatelem SBO, jehož ID je v poli ID adresáta

 lze použít pouze pro jednoho interního adresáta

 pro nastavení více interních uživatelů přidejte další řádek se shodným ID rozdělovníku

 

Seznam emailů

adresát je určen emailovou adresou, která je uvedena v poli Emailová adresa(y)

 

seznam emailových adres oddělených středníkem

 

pouze pro volbu odeslat Emailem

SQL seznam emailů

adresát je určen emailovými adresami, které poskytne SQL dotaz uvedený v poli Emailová adresa(y)

 V poli Emailové adresy lze použít tzv. tagy popsané výše.

 Př.

1.) výstrahu odeslat všem kontaktním osobám daného OP na dokladu

 => do pole Emailové adresy zadejte:

SELECT E_MailL FROM OCPR WHERE CardCode = N'{CardCode}'

 2) výstrahu odeslat pouze kontaktní osobě uvedené na dokladu

=> do pole Emailové adresy zadejte:

SELECT E_MailL FROM OCPR WHERE CardCode = N'{CardCode}' AND CntctCode = N'{CntctCode}'

 ID adresáta: určení adresáta pro Typ adresáta Int.uživatel, zadejte uživatelské jméno adresáta

Pouze pro volbu Odeslat interně

Jméno adresáta: nepovinný údaj, jméno adresáta, které bude uvedeno u emailové adresy

Emailové adresy: pouze pro Typ adresáta Seznam emailů a SQL seznam emailů, nastavení viz Typ adresáta

 




 RSS of this page

Author: Pavel Skalický   Version: 1.2   Last Edited By: Pavel Skalický   Modified: 14 Dec 2015