Table of Contents  [ Hide]

1. Úvod
2. Požadovaná nastavení
2.1 Instalace modulu
2.2 Nastavení zpráv / výstrah
2.3 Nastavení příjemců
3 Ukázkové příklady
3.1 Nastavení upozornění při založení nového artiklu
3.2 Nastavení upozornění při změně dokladu
3.3 Nastavení upozornění na změnu provedenou ve skupině artiklu

1. Úvod

Úprava umožňuje odesílání SBO zpráv (interních/externích) po uživatelsky definovaných událostech, které nastanou v SBO. Seznam příjemců včetně textů daných zpráv či mailů jsou též uživatelsky definovatelné.

2. Požadovaná nastavení

Uživatelské nastavení probíhá ve dvou uživatelských tabulkách. V tabulce „VCZ_ALERTS_SETP – VCZ Alerty SETUP“ jsou definovány zprávy pro jednotlivé události SBO, v tabulce „VCZ_MAIL_LIST – VCZ Rozdělovník odesílání“

2.1 Instalace modulu

Modul VCZ Alerty je součástí addonu VRIS. Pro jeho instalaci je zapotřebí zalicencovat a spustit instalaci u RQ1120-00.

Pozn.: Předpokladem pro řádné fungování modulu je nastavení VCZ Správy událostí (podrobněji viz technický popis - TEC1120-00 VCZ Alerty.doc)

2.2 Nastavení zpráv / výstrah

Uživatelská tabulka VCZ_ALERTS_SETP – VCZ Alerty SETUP 

Code: libovolný neduplicitní údaj

Name:  libovolný neduplicitní údaj

Action enabled: zaškrtnutí/odškrtnutí označuje, že je daná výstraha aktivní/neaktivní

Action order:  nepovinný údaj, určuje pořadí vyhodnocování, pokud není uvedeno je pořadí určeno dle Code

Trigger Object Type: určení typu objektu, pro který je dané pravidlo určeno (výběr z číselníku podporovaných typů)
Pozn: u uživatelských tabulek nelze sledovat konkrétní změnu, pouze dojde-li k její libovolné úpravě, bude zpráva odeslána

Trigger Transaction Type: pro jaký typ operace je pravidlo určeno (tzn. pouze při přidání / aktualizaci / vždy)

Trigger Fields Change: seznam polí (databázová jména) oddělený středníky, při jejichž změně platí dané pravidlo – tzn. když dojde ke změně alespoň jednoho z těchto uvedených polí, nastane daná událost a dojde k odeslání zprávy

Když je toto pole prázdné, platí dané pravidlo při jakékoliv změně daného objektu
Když je v Trigger Object Type zvolena volba „Uživatelská tabulka“, pak do tohoto pole zadejte její název

Trigger Filter: Dodatečné omezující podmínky pravidla pro zpracovávaný záznam – jde o část SQL klausule where – bude připojena pomocí AND k selectu pro daný záznam. Lze použít tzv. „Tagy“ (viz níže).
   
    Např.:
    (left(ItemCode, 1) = N'M') … pravidlo platí jen pokud ItemCode začíná na „M“
    10 < (SELECT sum(Quantity)  from POR1 WHERE DocEntry = {DocEntry}) … pravidlo pro odeslání výstrahy pro nákupní objednávku, jejíž objednané množství překročí 10 ks

Mail List: povinný údaj, jedná se o přiřazení rozdělovníku (tj. určení skupiny uživatelů/emailů), kterým bude daná výstraha zaslána – zadejte „ID Rozdělovníku“ viz nastavení příjemců

Subject: předmět/hlavička generované zprávy, lze použít tzv. „Tagy“ (zástupné znaky)

Text: text/tělo generované zprávy, lze použít tzv. „Tagy“

Object Link: přepínač, kterým se určuje, zda-li má být k interním zprávám připojena „oranžová šipka“ s odkazem na daný objekt

2.3 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ů daných výstrah. 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_ALERTS_SETP (viz popis nastavení), nebo v uživatelském poli Rozdělovník v hlavičce dokladu (když je toto pole neprázné, je rozdělovník určen tímto polem, když je prázdné tak z definice alertů).

Code: libovolný neduplicitní údaj
Name: libovolný neduplicitní údaj

ID Rozdělovníku: identifikace rozdělovníku, vazba na mail list v VCZ_ALERTS_SETP.
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 Emalové 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
Příklad nastavení:

Nastane-li událost, která má přidělený rozdělovník s ID - ROZ01, budou automaticky odeslány výstrahy:

1) dle definice prvního řádku – na email kontaktní osoby uvedené v hlavičce dokladu
2) dle definice druhého řádku – na dvě pevně stanovené emailové adresy
3) dle definice třetího řádku – interní zpráva uživateli manager
4) dle definice čtvrtého řádku – interní zpráva a současně email uživateli cablova

3 Ukázkové příklady

3.1 Nastavení upozornění při založení nového artiklu

Nastavení:

Při přidání nového artiklu je všem uživatelům definovaným v rozdělovníku ROZ – odeslána následující interní výstraha.

3.2 Nastavení upozornění při změně dokladu

Nastavení:

Při jakékoliv změně nákupní objednávky (například změna data dodání, zadání ceny) je bude odesláno upozornění s přímým odkazem na danou nákupní objednávku. Detail toho, co bylo změněno, naleznete ve změnovém protokolu.

Zobrazení změnového protokolu nad daným dokladem

3.3 Nastavení upozornění na změnu provedenou ve skupině artiklu

(označené ve speciálním uživatelském poli jako exportovat ANO)

Nastavení:

Při jakékoliv změně ve skupině artiklu, která má v uživatelském poli Exportovat artikly nastaveno ANO (tedy pouze pro takto označené skupiny), bude odesláno upozornění.