MAPISend.exe

Voľne šíriteľná aplikácia tretej strany. Nie je súčasťou inštalácie ABRA Gen. Ide o nástroj určený na zasielanie obsahu súborov e-mailom s použitím MAPI protokolu prostredníctvom e-mailového klienta (Pegasus Mail, OutlookExpress a pod.) Sú užitočné na tvorbu skriptov, v rámci použitia príkazov pri reportoch resp. použitia príkazov pri definovateľných exportoch v situáciách, kedy je potrebné automaticky poslať e-mail (zálohy, tlače do súborov, súbory def. exportov a pod.)

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

K rovnakému účelu je k dispozícii aj samotná externá aplikácia podobná MapiSend.exe, defaultne dodávaná v rámci inštalácie ABRA Gen.

Nemusí sa nijako konfigurovať, nakoľko e-maily odosiela pomocou e-mailového klienta podobne ako to interne robí ABRA Gen (viď Odoslanie výstupu e-mailom). Na vlastné používanie je teda jednoduchší ako blat.exe.

Základná syntax je nasledovná:

MAPISend /a address(es) [voliteľné prepínače], napr.

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

  • /a address: zoznam príjemcov (oddelené stredníkmi)
  • [voliteľné prepínače]: skupina voliteľných prepínačov, pomocou ktorých je možné stanoviť napr. predmet mailu (/s subject, špecifikovať obsah mailu (/b body), súbor, ktorý má byť odoslaný ako obsah mailu, pripojiť prílohy, nastaviť požiadavku na potvrdenie čítania (/r), požiadavku na otvorenie e-mailového klienta (/e) a pod.

Poslanie mailu vyzerá napr.:

C:\MAPISend /a <komu@kam.sk> /s <popis spravy> /b <telicko spravy> /f <c:\cesta\subor.ext>

<komu@kam.sk> je e-mailová adresa, komu sa e-mail s obsahom <telicko spravy> má poslať
<popis spravy> je to, čo má byť uvedené v položke Predmet mailu (Subject)
<c:\cesta\subor.ext> je súbor, ktorý bude pripojený ako príloha

Podrobný popis aplikácie a syntaxe vr. príkladov viď súbor mapisend.txt, ktorý je súčasťou inštalácie.

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.

Príklad realizácie odoslania súboru *.pdf s vytlačeným dokladom zálohového listu odberateľovi:

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

c:\mapisend /a %EMAIL% /s Zalohovy list /b Predpis zálohy na základe vašej objednávky. /f %FILENAME% /e

Kde %EMAIL% je divoká premenná, ktorá bude nahradená po vyhodnotení 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 mail.bat (na rovnakej ceste ako blat.exe):

c:\mapisend.exe /a %1% /s Zalohovy list /b Predpis zálohy na základe vašej objednávky. /f %2   
echo.
pause

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

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

Pokiaľ je telo e-mailu dlhšie, je možné si ho nadefinovať do nejakého súboru a tento potom pripojiť rovnako ako prílohu. 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."

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

c:\mapisend /a %EMAIL% /s Zalohovy list /b Viď prílohy. /f %FILENAME%;c:\email.txt /e

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.