Propojení modulu Tok práce a e-mailu

 

Podmínky funkčnosti

Podmínkou propojení je funkčnost některé z následujících systémových procedur:

 

▪master.dbo.SMTP_sendmail        (proc_mail = 0)

▪master..xp_sendmail                  (proc_mail = 1)

▪msdb..sp_send_dbmail                (proc_mail = 2)

▪master..xp_smtp_sendmail                (proc_mail = 3)

▪master.dbo.vp_smtp                (proc_mail <> 9)

 

které umožňují volat služby elektronické pošty přímo z MS SQL Serveru. Nastavení těchto procedur musí provést administrátor SQL serveru a počítačové sítě dle systémové dokumentace.

Pro funkčnost přímého volání úkolu workflow kliknutím na přílohu mailu TPV2000_FUxxxx.t2f, musí být též funkční procedura master.dbo.xp_cmdshell pro libovolné uživatele s 

neadministrátorskými právy k SQL serveru. Nastavení je popsáno v systémové dokumentaci k MS SQL Serveru. Preferovaným způsobem volání pro MS SQL 2014 je způsob 2 - msdb..sp_send_dbmail,

což je integrovaná SQL funkčnost Database Mail.

 

Odesílání e-mailů z Microsoft SQL Serveru

 

1. Database Mail

 

 

 

 

2. Nastavení Proxy

 

Nutná nastavení na úrovní serverového OS a MS SQL Serveru

(příklad: Windows Server 2012 R2 a Microsoft SQL Server 2014)

 

▪založení doménového proxy účtu (např. BB\sqlproxy), je členem skupiny Domain Users

 

 

▪Security > Credentials > vytvoření ##xp_cmdshell_proxy_account##  s Identity = BB\sqlproxy

 

(možno i skriptem)

 

USE master

GO

 

EXECUTE sp_xp_cmdshell_proxy_account 'BB\sqlproxy','password'

GO

 

GRANT CONTROL SERVER TO [BB\sqlproxy]

GO

 

 

▪SQL Server Agent > Proxies > Operating System (CmdExec) > vytvoření proxy CmdExec a propojení na Credential  ##xp_cmdshell_proxy_account##

 

 

 

3. Nastavení práv spouštění

 

▪nastavení práva spouštění procedury xp_cmdshell pro proxy uživatele BB\sqlproxy

 

GRANT EXECUTE ON master.dbo.xp_cmdshell TO [BB\sqlproxy]

GO

 

▪nastavení práva spouštění procedury sp_send_dbmail skupině PUBLIC

 

GRANT EXECUTE ON msdb..sp_send_dbmail TO [public]

GO

 

Nastavení na úrovni modulu Tok práce

 

1. Nastavení předávání úkolu e-mailem

Úkol musí mít nastaven příznak č. 3 na hodnotu „E – po zahájení úkolu obdrží mail“. Nastavení doporučujeme provést již ve scénáři !

 

 

 

2. Nastavení emailové adresy člena OJ

Pokud je u úkolu nastaven příznak předávání emailem, musí mít příslušný člen OJ, definovaný v úkolu, nastavenu svoji emailovou adresu v poli E – mail: Členové OJ (KACL).

Pokud uživatel nemá uvedené pole vyplněno, nastavení úkolu z hlediska emailu se ignoruje.

 

 

Aplikace wfakce.exe

 

Tok práce se nevolá již prostřednictvím  DDE ale přes novou komunikaci, přímým voláním událostí (jako mezi instancemi TPV2000Plus).

Pokud je wfakce umístěn a zaregistrován ve stejném adresáři jako ostatní programy TPV2000Plus, není nutný soubor bbcurdir.ini s odkazem na adresář s instancí TPV2000Plus.

Pokud není potřeba volat TPV pro konkrétní databázi, pak není nutný ani soubor wfakce.ini. Wfakce.ini se nyní ani automaticky nevytváří (dříve ano).

 

Informace o úkolu prostřednictvím emailu.

Pokud jsou splněny výše uvedené podmínky, obdrží příslušný uživatel – člen OJ emailem zprávu ve formě:

 

Předmět        Úkol: <nazev_akce>, pro tok: <nazev_toku>

 

Text:               Termín ukončení úkolu: <plánované datum ukončení>

 

         Popis úkolu:

                       <popis úkolu>

 

 

Přímé volání úkolu toku práce

Pokud je nastaveno přímé volání úkolu toku práce, obdrží uživatel navíc emailem přílohu s extenzí T2F. Kliknutím na přílohu se otevře příslušný úkol v modulu Tok práce: Pracovní úkoly (WFPU),

kde jej lze návazně ihned zpracovat a schválit.

 

Nastavení přímého volání na úrovni SQL serveru

Na SQL serveru nutno zkopírovat do určitého adresáře soubor TPV2000.t2f. Do tabulky wf_nastaveni nutno zadat do pole cesta_mail_prilohy cestu na tento soubor, např. „C:\TPV2000\\WF_prilohy”.

 

Nastavení přímého volání na úrovni PC

Nutno vyvolat program wfakce.exe, který je umístěn v aktuálním adresáři s instalací TPV2000Plus na příslušném PC s parametrem /r. (wfakce /r). Tím se program zaregistruje pro soubory s příponou t2f

a při kliknutí na přílohu, kterou obdrží uživatel mailem společně s informací o úkolu workflow, vyvolá tento program přímo příslušný úkol v modulu Tok práce.

 

 

Aplikace wfakce.exe pracuje s následujícími soubory:

 

▪bbcurdir.ini (V souboru je uveden adresář, v němž se nachází klientská část TPV2000Plus pro případy, že je aplikace wfakce.exe umístěna v odlišném adresáři (aby mohlo dojít k volání

▪modulu Tok práce).

 

 

▪wfakce.exe (samotná aplikace pro přímíé volání úkolu toku práce s přílohy e-mailu)

 

▪wfakce.ini (v souboru je uvedeno jméno databáze, ke které se má aplikace wfakce.exe připojit v rámci otevření pracovního úkolu).

 

 

Konfigurace volání e-mailového klienta

Do tpv_config byla doplněna pole proc_mail a log_mail

 

▪Proc_mail        bez Dimenze,        hodnota 0 (implicitní), volá master.dbo.SMTP_sendmail

                         hodnota 1, volá master.dbo.xp_sendmail

         s Dimenzí                volá implicitně master.dbo.vp_smtp

         hodnota 9        nevolá se žádná procedura

 

▪Log_mail        hodnota 1 - údaje, které se předávávají do mailového klienta se evidují v tabulce tpv_log_posli_mail

 

---

Další odkazy:

 

Vyhledávání, filtrování

Klávesové zkratky

Kontextové menu

Chybová hlášení

 

Technická podpora

Kontakty

 

Copyright © BB consult engineering s.r.o. 1998-2025.

All Rights Reserved.