EML/MAPI/mailto/SMTP
V systéme ABRA Gen sa na rôznych miestach používa odosielanie e-mailov. Rieši sa viacero spôsobov, podľa potrieb daného miesta programu. Napr. pomocou:

Od verze ABRA Gen 25.3 bylo MAILTO a MAPI, v místech popsaných níže nahrazeno generováním EML souboru (MIME standard) s obsahem e-mailu včetně příloh do Windows Temp složky a následně jeho otevřením výchozím e-mailovým klientem pro otevírání souborů s příponou eml.
Tento způsob otevírání nových e-mailů s přílohami na rozdíl od MAPI/OLE podporuje spolu s už podporovanými klienty (classic Microsoft Outlook, Mozilla Thunderbird, etc.) i nový Microsoft Outlook (tzv. Outlook pro Windows).
Nahrazení MAILTO proběhlo v těchto místech:
- v paneloch s adresou – funkčné tlačidlo Odoslať E-mail vedľa poľa E-mail
- v agende Adresár firiem - funkcia E-mail
- v agende Adresár osôb - funkcia E-mail
- v agende Prevádzkarne - funkcia E-mail
- v agende Call centrum - tlačidlo Poslať e-mail
- v pluginu Tlačidlá s akciami (ButtonsPlugin) – MailToCommand
- po kliknutí na odkaz mailto: (niekde, kde sa vyskytuje html, vo wiki a pod.)
Nahrazení MAPI proběhlo v těchto místech:
- v rámci odoslania tlačového výstupu e-mailom prostredníctvom e-mailového klienta - možnosti, ako vyvolať odoslanie tlačového výstupu e-mailom, viď Odoslanie e-mailom vo zvolenom formáte, tu viď voľby pre odoslanie prostredníctvom e-mailového klienta, tzn.:
- v dialógovom okne pre výber tlačovej zostavy - funkčné tlačidlo E-mail,
- v náhľade (preview) tlačovej zostavy - funkčné tlačidlo Poslať dáta e-mailom,
- v rámci funkcie Nastavenie tlače po uložení,
- a. i.
- v agende Kampane - funkčné tlačidlo Test e-mailu
- v prípade definovateľných exportov, ktoré majú nastavenú akciu pre spracovanie Odoslať e-mailom
- pri výskyte chyby v systéme ABRA Gen u klienta V rámci možnosti odoslať chybové hlásenie výrobcovi
Původní MAPI bylo z technických důvodů ponecháno na těchto místech:
- ISDOC driver, tzn. pri spracovaní dokumentov kategórie ISDOC vydaný, ktoré majú v parametroch svojej kategórie ako Spôsob spracovania a odoslania nastavené Spracovať a odoslať východiskovým e-mailovým klientom alebo pri ktorých je tento spôsob spracovania zvolený až v rámci Sprievodcu spracovaním dokumentov ISDOC vydaných pri samotnom spracovaní príp. sa sem predvyplní z nastavenia na firme

V ABRA Gen sa využíva napr. v týchto miestach:
- v paneloch s adresou – funkčné tlačidlo Odoslať E-mail vedľa poľa E-mail
- v agende Adresár firiem - funkcia E-mail
- v agende Adresár osôb - funkcia E-mail
- v agende Prevádzkarne - funkcia E-mail
- v agende Call centrum - tlačidlo Poslať e-mail
- v pluginu Tlačidlá s akciami (ButtonsPlugin) – MailToCommand
- po kliknutí na odkaz mailto: (niekde, kde sa vyskytuje html, vo wiki a pod.)
Otevře se aplikace asociovaná s protokolem mailto:. Čerpá se z asociací (např. na Windows 7 viz Nastavení výchozích programů/Nastavení přidružení programů/nastavení pro protokol mailto:, na Windows 8/Windows 10 viz Přidružení protokolu). Ide o rovnakú situáciu, ako keď sa v príkazovom riadku Windows (Spustiť) zavolá príkaz "mailto:".
Při komunikaci s Mozilla Thunderbit 64bit může na některých stanicích dojít k problémům s komunikací. V takovém případě doporučujeme přejít na Mozilla Thunderbit 32bit.

V ABRA Gen sa využíva napr. v týchto miestach:
- v rámci odoslania tlačového výstupu e-mailom prostredníctvom e-mailového klienta - možnosti, ako vyvolať odoslanie tlačového výstupu e-mailom, viď Odoslanie e-mailom vo zvolenom formáte, tu viď voľby pre odoslanie prostredníctvom e-mailového klienta, tzn.:
- v dialógovom okne pre výber tlačovej zostavy - funkčné tlačidlo E-mail,
- v náhľade (preview) tlačovej zostavy - funkčné tlačidlo Poslať dáta e-mailom,
- v rámci funkcie Nastavenie tlače po uložení,
- a. i.
- v agende Kampane - funkčné tlačidlo Test e-mailu
- v prípade definovateľných exportov, ktoré majú nastavenú akciu pre spracovanie Odoslať e-mailom
- ISDOC driver, tzn. pri spracovaní dokumentov kategórie ISDOC vydaný, ktoré majú v parametroch svojej kategórie ako Spôsob spracovania a odoslania nastavené Spracovať a odoslať východiskovým e-mailovým klientom alebo pri ktorých je tento spôsob spracovania zvolený až v rámci Sprievodcu spracovaním dokumentov ISDOC vydaných pri samotnom spracovaní príp. sa sem predvyplní z nastavenia na firme
- pri výskyte chyby v systéme ABRA Gen u klienta V rámci možnosti odoslať chybové hlásenie výrobcovi
Niekoľko informácií k MAPI: existujú 2 úrovne MAPI: SimpleMAPI a ExtendedMAPI. SimpleMAPI je množina 12 metód, ktoré implementujú základnú e-mailovaciu funkcionalitu. ExtendedMAPI naopak umožňuje kompletné ovládanie e-mailovej funkcionality – práca so zložkami, zakladanie účtov a pod. SimpleMAPI ovláda väčšina e-mailových programov: Outlook Express, Thunderbird, Outlook (ale nie všetky verzie) a i. Naproti tomu Extended MAPI ovláda len obmedzené množstvo klientov, napr. Outlook (nie Express!) a administračná konzola pre server MS Exchange.
Kombinácia SimpleMAPI rozhrania MS Outlook
V prípade SimpleMAPI rozhrania v kombinácii s Outlookom dochádza k problémom, kedy Outlook použije formát odoslaného e-mailu RTF, aj keď má nastavené, aby tak nečinil, čo vedie k problémom s čitateľnosťou príloh u adresátov e-mailu. Preto je k dispozícii parameter UseOutLookWithOLE v Nexus.cfg, ktorým je možné zaistiť, že sa SimpleMAPI rozhranie nepoužije. Či sa teda pre odoslanie e-mailu v danom mieste ABRA Gen použije štandardne SimpleMAPI rozhranie alebo OLE rozhranie, závisí na stave parametra UseOutLookWithOLE v Nexus.cfg a na tom, aký je váš východiskový klient.
Kombinace SimpleMAPI rozhraní Mozilla Thunderbird
Při komunikaci s Mozilla Thunderbit 64bit může na některých stanicích dojít k problémům s komunikací. V takovém případě doporučujeme přejít na Mozilla Thunderbit 32bit.
Upozornenie na použitie viacerých e-mailových adries naraz
Pokud se jedná o místo ABRA Gen, kde se e-mail posílá přes SimpleMAPI nebo OLE (tedy nikoli přes mailto:) a o případ, kdy je zadáno více mail. adres, oddělených středníkem nebo čárkou (např. funkční tlačítko Test e-mailu v agendě Kampaně) a na základě parametru UseOutLookWithOLE=0 se používá SimpleMAPI, viz výše, tak může dojít k tomu, že se chybně interpretují oddělovače (resp. neinterpretují se jako oddělovače), tudíž vzniklá mail. adresa je neplatná. Deje sa napr. práve pri MS Outlook. V takom prípade buď musíte predvyplnené adresy pred odoslaním e-mailu upraviť, alebo odporúčame nepoužívať hodnotu UseOutLookWithOLE=0.
Pokiaľ na OS Windows 8/Windows 10 dochádza k problémom pri odosielaní prostredníctvom Outlooku, môže byť na vine zapnuté riadenie užívateľských účtov. Pokiaľ by ani jeho vypnutie nepomohlo, je potrebné v registri:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System nastaviť hodnotu EnableLUA na 0.
Nasledujúci popis je nad rámec tejto príručky a je len doplňujúcou informáciou pre lepšiu orientáciu užívateľa pre prípad, že má s vyvolaním mailového klienta z vyššie uvedených daných miest ABRA Gen nejaké ťažkosti. Platí pre Windows 7/Windows 8. Ak máte iný operačný systém, tak bude situácia podobná, ale nie je možné zaručiť, že úplne rovnaká. Avšak nasledujúci popis by mohol byť vodítkom pre zistenie príčiny prípadných ťažkostí a ich odstránenie.
Informácia o prítomnosti SimpleMAPI rozhrania a o východiskovom e-mailovom klientovi je evidovaná v registroch vášho operačného systému. Východiskový klient pre SimpleMAPI rozhranie je užívateľsky vidieť v nastavení pridruženia pre program ako "MAPI – Odoslať poštu" (napr. vo Windows 7 viď Ovládacie panely/Východiskové programy). Nastaví sa tiež nastavením východiskového klienta priamo v aplikácii.
Boli zaznamenané prípady, kedy sa po vizuálnom nastavení mailového klienta ako východiskového, neuskutočnil adekvátny záznam do registrov do vetiev, kde sa prítomnosť SimpleMAPI rozhrania resp. východiskový klient zisťuje. Pokiaľ teda sa vám otvára iný klient, ako očakávate podľa vášho nastavenia, skontrolujte obsah príslušných registrov korešpondujúcich s popisom uvedeným ďalej.
V systéme ABRA Gen je k dispozícii parameter UseOutLookWithOLE, ktorým je možné ovplyvniť, či sa e-mail bude posielať cez OLE rozhranie Outlooku, alebo cez SimpleMAPI rozhranie. Výsledok ale závisí tiež na tom, aké e-mailové klienty máte nainštalované, či a ktoré máte nastavené ako východiskové, či je na danom počítači k dispozícii SimpleMAPI rozhranie atď. Podľa týchto skutočností sa vyvolá príslušný klient buď jednou alebo druhou metódou, príp. systém ABRA Gen oznámi, že potrebný poštovný klient nie je k dispozícii. Najprv sa teda vykonajú príslušné zistenia, či je na počítači prítomné SimpeMAPI rozhranie a aký východiskový klient pre SImpleMAPI:
- Prítomnosť SimpeMAPI rozhrania sa pre účely ABRA Gen zisťuje v registroch:
\\\Registry\HKLM\SOFTWARE\{Wow6432Node\}Microsoft\Windows Messaging Subsystem (podvetva {Wow6432Node\} pre 64 bit Windows):
- Či je rozhranie inštalované, sa zisťuje z existencie a hodnoty kľúča ExtendedMAPI (MAPIX). Pokiaľ je tu MAPIX = 1 , tak sa berie, že SimpleMAPI rozhranie je prítomné.
- Verzia MAPI sa zisťuje z kľúča MAPIXVER.
- Pokiaľ sa podľa textu vyššie nenašlo ExtendedMAPI (nepodarilo sa prečítať hodnotu MAPIX), tak sa pokúšajú overiť jeho prítomnosť iným spôsobom, a to z registrov prehľadaním knižníc implementujúcich MAPI pri jednotlivých e-mailových klientoch (z vetve \\\Registry\ HKLM\SOFTWARE\Clients\Mail (v kľúči DLLPathEx príp. v DLLPath)) a testuje sa, či implementujú 12 metód zo SimpleMAPI rozhrania. Pokiaľ sa nájde nejaká taká DLL, tak sa berie, že SimpleMAPI rozhranie je prítomné.
- Aký je Východiskový klient pre SimpleMAPI sa čerpá najprv z registrov \\\Registry\HKCU\SOFTWARE\Clients\Mail (z východiskovej hodnoty). Pozor, nie HKLM, ale HKCU! (Toto sa mení nastavením východiskového klienta pre daného užívateľa.)
- Pokiaľ sa nepodarilo zistiť východiskového klienta z HKCU registrov, čerpá sa z vetvy \\\Registry\HKLM\SOFTWARE\Clients\Mail.
- Prítomnosť Outlook OLE sa zisťuje vyvolaním systémovej funkcie, či je k dispozícii objekt ProgID='Outlook.Application'.
Ďalej sa postupuje podľa hodnoty parametra UseOutLookWithOLE:
- =0 - Tzn. e-mail sa má poslať pomocou MAPI ⇒ Pošle sa pomocou knižnice JCL + MAPI, tzn. zavolá sa ten e-mailový klient, ktorý je východiskovým klientom pre SimpleMAPI. Pokiaľ SimpleMAPI rozhranie nie je prítomné (viď vyššie) alebo nie je k dispozícii východiskový poštový klient, objaví sa chybové hlásenie ABRA Gen, že potrebný e-mailový klient nie je nainštalovaný.
- =1 - Tzn. ak je Východiskovým klientom pre SimpleMAPI rozhranie Outlook, tak sa e-mail má poslať pomocou OLE Outlooku, inak ako pri hodnote 0. ⇒ Podľa výsledkov prítomnosti Outlook OLE, sa toto použije prednostne. V opačnom prípade ako pri hodnote 0.
- 2 ⇒ Vždy cez OLE Outlooku.
- =iná hodnota - tzn. ako v prípade hodnoty 0.
V prípade problémov je možné využiť logovanie [Log.Email] v Nexus.cfg, viď kap. Logovanie chodu aplikácie. O.i. zaloguje hodnoty získané pri zisťovaní SimpleMAPI:
UseOutLookWithOLE - aktuálna hodnota parametra
AnySimpleMAPIClientInstalled - či je prítomnosť SimleMAPI rozhrania - viď vyššie
IsOutlookInstalled - či je k dispozícii Outlook s OLE rozhraním
DefaultMAPIClient - východiskový SimpleMAPI klient (len, keď UseOutLookWithOLE=1)
NeedOpenOutlookOLE - 1, keď UseOutLookWithOLE = 2 alebo ( UseOutLookWithOLE = 1 a zároveň IsOutlookInstalled )
AnyClientInstalled - 1, keď (NeedOpenOutlookOLE=1 a zároveň IsOutlookInstalled) alebo (NeedOpenOutlookOLE=0 a zároveň AnySimpleMAPIClientInstalled )
Pokiaľ je AnyClientInstalled=0, potom vyskočí hláška, že nie je nainštalovaný žiaden klient

Napr. agenda Odoslané e-maily, kde sa nevolá žiadny e-mailový klient.