MAPISend.exe

Volně šiřitelná aplikace třetí strany. Není součástí instalace ABRA Gen. Jedná se o nástroj určený pro zasílání obsahu souborů e-mailem s použitím MAPI protokolu prostřednictvím e-mailového klienta (Pegasus Mail, OutlookExpress apod.). Jsou užitečné pro tvorbu skriptů, v rámci použití příkazů u reportů resp. použití příkazů u definovatelných exportů v situacích, kdy je třeba automaticky poslat e-mail (zálohy, tisky do souborů, soubory def. exportů apod.)

Nástroj MAPISend byl dříve (do v. 12.02 včetně) součástí instalace ABRA Gen. Aktuálně není, nicméně je možné si jej stáhnout z webu.

K témuž účelu je k dispozici též vlastní externí aplikace podobná MapiSend.exe, defaultně dodávaná v rámci instalace ABRA Gen.

Nemusí se nijak konfigurovat, jelikož e-maily odesílá pomocí e-mailového klienta podobně jako to dělá interně ABRA Gen (viz Odeslání výstupu e-mailem). Na vlastní používání je tedy jednodušší než blat.exe.

Základní syntaxe je následující:

MAPISend /a address(es) [volitelné přepínače], např.

MAPISend /a address(es) [/N name(s)] [/S subject] [/B body] [/F filename(s)] [/R] [/E], kde:

  • /a address: seznam příjemců (odděleno středníky)
  • [volitelné přepínače]: řada volitelných přepínačů, pomocí nichž lze stanovit např. předmět mailu (/s subject, specifikovat obsah mailu (/b body), soubor, který má být odeslán jako obsah mailu, připojit přílohy, nastavit požadavek na potvrzení čtení (/r), požadavek na otevření e-mailového klienta (/e) apod.

Poslání mailu vypadá např.:

C:\MAPISend /a <komu@kam.cz> /s <popis zpravy> /b <telicko zpravy> /f <c:\cesta\soubor.ext>

<komu@kam.cz> je e-mailová adresa, komu se e-mail s obsahem <telicko zpravy> má poslat
<popis zpravy> je to, co má být uvedeno v položce Předmět mailu (Subject)
<c:\cesta\soubor.ext> je soubor, který bude připojen jako příloha

Podrobný popis aplikace a syntaxe vč. příkladů viz soubor mapisend.txt, který je součástí instalace.

Příklady využití v ABRA Gen:

  • Odesílání souborů s tiskovými reporty vygenerovanými po uložení záznamů mailem v rámci funkce Nastavení po uložení
  • Odesílání souborů s definovatelnými exporty vygenerovanými po zpracování daného def. exportu mailem příkazem zadaným v definici exportu nebo zadaným až před zpracováním exportu, viz popis def. exportu - vlastnosti Spustit po zpracování a Nabídka(volba)
  • apod.

Příklad realizace odeslání souboru *.pdf s vytištěným dokladem zálohového listu odběrateli:

V agendě Zálohových listů vydaných si ve funkci Nastavení tisku po uložení nastavíme volbu Tisknout do *.pdf souboru a zadáme odpovídající příkaz, např.:

c:\mapisend /a %EMAIL% /s Zalohovy list /b Předpis zálohy na základě vaší objednávky. /f %FILENAME% /e

Kde %EMAIL% je divoká proměnná, která bude nahrazena po vyhodnocení parametru spuštění (pojmenovaného skriptu) téhož jména, který musí být definován ve zvolené tiskové sestavě a který po vyhodnocení vrátí e-mail adresu odběratele použitého v hlavičce dokladu, a kde %FILENAME% je divoká proměnná, která bude nahrazena jménem vygenerovaného souboru, který vrací defaultní parametr spuštění (pojm. skript) FILENAME. Dále viz Parametry spuštění (pojmenované skripty) a použití příkazů u reportů resp. použití příkazů u definovatelných exportů.

Celé lze zrealizovat i nějakým dávkovým souborem, do něhož můžeme umístit i volání jiných akcí, jako např. zazipování posílaného souboru, výpis informační zprávy o prováděné akci apod. Nadefinujeme si odpovídající příkaz, např. formou dávkového souboru mail.bat (na stejné cestě jako blat.exe):

c:\mapisend.exe /a %1 /s Zalohovy list /b Předpis zálohy na základě vaší objednávky. /f %2   
echo.
pause

Příkaz ve funkci Nastavení po uložení v agendě Zálohových listů pak může vypadat např. následovně:

c:\mail.bat %EMAIL% %FILENAME%

Pokud je tělo e-mailu delší, lze si jej nadefinovat do nějakého souboru a tento pak připojit rovněž jako přílohu. Nadefinujeme si soubor s textem, který bude tvořit obsah mailu např:

c:\email.txt

S obsahem např. "Zasíláme Vám zálohový list k úhradě. Originál dokladu Vám bude zaslán dodatečně poštou."

Příkaz ve funkci Nastavení po uložení v agendě Zálohových listů pak může vypadat např. následovně:

c:\mapisend /a %EMAIL% /s Zalohovy list /b Viz přílohy. /f %FILENAME%;c:\email.txt /e

Odesílání tiskových výstupů e-mailem však lze realizovat mnohem jednodušeji a to přímo pomocí funkcí pro následné zpracování tisk. výstupů, viz Odeslání e-mailem ve zvoleném formátu.