Blat.exe

Voľne šíriteľná aplikácia tretej strany. Nie je súčasťou inštalácie ABRA Gen. Jedná sa o nástroj určený na zasielanie obsahu súborov mailom s použitím SMTP protokolu.

Blat je užitočný na tvorbu skriptov, kde je potrebné automaticky poslať mail (zálohy, tlače do súborov a pod.)

Nástroj Blat bol predtým (do v. 12.02 vrátane) súčasťou inštalácie ABRA Gen. Aktuálne nie je, je však možné si ho stiahnuť z webu.

Aby ste mohli použiť Blat.exe, musíte mať prístup na SMTP server cez TCP-IP.

Blat dokáže pracovať s adresou SMTP servera a adresou odosielateľa (položkou "From:") podľa informácií uložených v registri (pred použitím blat.exe je potrebné vykonať príslušnú registráciu, viď ďalej). Každopádne ako serverová adresa, tak položka From môže byť prepísaná použitím príslušných parametrov. K dispozícii sú aj ďalšie možnosti, ako pripojiť binárnu či textovú prílohu, špecifikovať predmet mailu a pod. Všetko je voliteľne možné uskutočniť z príkazového riadku.

Podrobný popis aplikácie a syntaxe vrát. príkladov viď súbor blat.txt, ktorý je súčasťou daného nástroja.

Základná syntax je nasledovná:

blat <filename> -to <recipient> [voliteľné prepínače], kde:

  • <filename>: súbor, ktorý má byť odoslaný ako obsah mailu ('-' pre vstup z príkazového riadka)
  • - to <recipient>: zoznam príjemcov (tiež -t) (oddelené čiarkami)
  • [voliteľné prepínače]: rad voliteľných prepínačov, pomocou ktorých je možné stanoviť napr. predmet mailu, špecifikovať obsah mailu, pripojiť prílohy, nastaviť dôležitosť mailu a pod.

Poslanie mailu vyzerá napr.:

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

<komu> je e-mailová adresa, komu sa mail so súborom c:\obsahmailu.txt má odoslať, napr. novak@post.sk
<subjekt> je text, ktorý má byť uvedený v položke Predmet mailu
<attacht> je textový súbor ako príloha

Pred použitím aplikácie Blat.exe je potrebné zaregistrovať, kde je mail-server a ako aký užívateľ sa naň budeme pripájať:

blat -install <server> <user>, kde

  • <server>: adresa SMTP servera
  • <user>: platná mailová adresa odosielateľa

Aplikáciu blat.exe je potrebné vyvolávať buď s úplne zadanou cestou alebo ju mať uloženú na mieste, ku ktorému je definovaná cesta v systéme (path).

Príklady využitia v ABRA Gen:

  • Odosielanie súborov s tlačovými reportmi vygenerovanými po uložení záznamov mailom v rámci funkcie Nastavenie po uložení
  • Odosielanie súborov s definovateľnými exportmi vygenerovanými po spracovaní daného def. exportu mailom príkazom zadaným v definícii exportu alebo zadaným až pred spracovaním exportu, viď popis def. exportu - vlastnosti Spustiť po spracovaní a Ponuka(voľba)
  • a pod.

Realizácia odoslania e-mailom súboru *.pdf s vytlačeným dokladom zálohového listu odberateľovi

Nadefinujeme si súbor s textom, ktorý bude tvoriť obsah mailu napr.:

c:\email.txt

S obsahom napr. "Zasielame Vám zálohový list na úhradu. Originál dokladu Vám bude zaslaný dodatočne poštou."

V agende Zálohových listov vydaných si vo funkcii Nastavenie tlače po uložení nastavíme voľbu Tlačiť do *.pdf súboru a zadáme zodpovedajúci príkaz, napr.:

blat c:\email.txt -to %EMAIL% -subject "Súbor zálohy" -attach %FILENAME%

Kde %EMAIL% je divoká premenná, ktorá bude nahradená po vyhodnotení tzv. parametra spustenia (pomenovaného skriptu) s rovnakým názvom, ktorý musí byť definovaný v zvolenej tlačovej zostave a ktorý po vyhodnotení vráti e-mailovú adresu odberateľa použitého v hlavičke dokladu, a kde %FILENAME% je divoká premenná, ktorá bude nahradená menom vygenerovaného súboru, ktorý vracia defaultný parameter spustenia (pomen. skript) FILENAME. Ďalej viď Parametre spustenia (pomenované skripty) a použitie príkazov v reportoch resp. použití príkazov v definovateľných exportoch.

Celé to je možné zrealizovať aj nejakým dávkovým súborom, do ktorého môžeme umiestniť aj vyvolanie iných akcií, ako napr. zazipovanie posielaného súboru, výpis informačnej správy o uskutočňovanej akcii a pod. Nadefinujeme si príslušný príkaz, napr. formou dávkového súboru, pre jednoduchosť napr. súbor ablat.bat (na rovnakej ceste ako blat.exe):

blat.exe c:\email.txt -to %1% -subject "Súbor zálohy" -attach %2
echo.
pause

Príkaz vo funkcii Nastavenie po uložení v agende Zálohových listov potom môže vyzerať napr. nasledovne:

ablat.bat %EMAIL% %FILENAME%

Odosielanie tlačových výstupov e-mailom však je možné realizovať oveľa jednoduchšie a to priamo pomocou funkcií pre následné spracovanie tlač. výstupov, viď Odoslanie e-mailom v zvolenom formáte.