Blat.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ů mailem s použitím SMTP protokolu.

Blat je užitečný pro tvorbu skriptů, kde je třeba automaticky poslat mail (zálohy, tisky do souborů apod.)

Nástroj Blat 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.

Abyste mohli použít Blat.exe, musíte mít přístup na SMTP server přes TCP-IP.

Blat umí pracovat s adresou SMTP serveru a adresou odesílatele (položkou "From:") podle informací uložených v registry (před použitím blat.exe je třeba provést příslušnou registraci, viz dále). Nicméně jak serverová adresa, tak položka From může být přepsána použitím odpovídajících parametrů. K dispozici jsou i další možnosti, jako připojit binární či textovou přílohu, specifikovat předmět mailu apod. Vše je volitelně možné provést z příkazové řádky.

Podrobný popis aplikace a syntaxe vč. příkladů viz soubor blat.txt, který je součástí instalace daného nástroje.

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

blat <filename> -to <recipient> [volitelné přepínače], kde:

  • <filename>: soubor, který má být odeslán jako obsah mailu ('-' pro vstup z příkazové řádky)
  • - to <recipient>: seznam příjemců (též -t) (odděleno čárkami)
  • [volitelné přepínače]: řada volitelných přepínačů, pomocí nichž lze stanovit např. předmět mailu, specifikovat obsah mailu, připojit přílohy, nastavit důležitost mailu apod.

Poslání mailu vypadá např.:

blat.exe c:\obsahmailu.txt -to <komu> -subject <subjekt> -attacht c:\pripojenysoubor.txt

<komu> je e-mailová adresa, komu se mail se souborem c:\obsahmailu.txt má odeslat, např. novak@post.cz
<subjekt> je text, který má být uveden v položce Předmět mailu
<attacht> je textový soubor jako příloha

Před použitím aplikace Blat.exe je třeba zaregistrovat, kde je mail-server a jako jaký uživatel se na něj budeme připojovat:

blat -install <server> <user>, kde

  • <server>: adresa SMTP serveru
  • <user>: platná mailová adresa odesílatele

Aplikaci blat.exe je třeba buď volat s plně zadanou cestou nebo ji mít uloženu na místě, k němuž je definována cesta v systému (path).

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.

Realizace odeslání e-mailem souboru *.pdf s vytištěným dokladem zálohového listu odběrateli

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."

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ř.:

blat c:\email.txt -to %EMAIL% -subject "Soubor zalohy" -attach %FILENAME%

Kde %EMAIL% je divoká proměnná, která bude nahrazena po vyhodnocení tzv. 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-mailovou 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, pro jednoduchost např. soubor ablat.bat (na stejné cestě jako blat.exe):

blat.exe c:\email.txt -to %1 -subject "Soubor zalohy" -attach %2  
echo.
pause

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

ablat.bat %EMAIL% %FILENAME%

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.