Nastavení součásti MailboxReader

Nastavení součásti MailboxReader

Nastavení je uloženo v souboru MailboxReader.exe.config ve složce Bin. Soubor je formátu XML a platí pro něj tedy stejná pravidla jako pro soubor Web.config viz Nastavení Portálu.
Soubor vytvořte zkopírováním souboru "Bin\MailboxReaderSample.exe.config". Pro editaci můžete použít Poznámkový blok ve Windows.

Připojení k databázi

Připojení k databázi se definuje v sekci:

<configuration>
 <connectionStrings>
  <add name="Alvao.Hd.MailboxReader.Properties.Settings.Db" connectionString="Data source=localhost;… />
 </connectionStrings>
</configuration>

Do atributu connectionString zapište připojovací řetězec k databázi. Formát řetězce je stejný jako v nastavení Portálu viz Připojení k databázi.

Odesílání e-mailů

Komponenta MailboxReader od veze 7.1 odesílá veškeré emailové zprávy odcházející ze systému ALVAO. Je třeba nastavit adresu SMTP serveru pro odesílání zpráv elektronické pošty v databázi pomocí nástroje Admin. K nastavení SMTP se dostanete přes menu Spravovat - Nastavení.

Emaily jsou odesílány v dávkách, výchozí interval odesílání je 5 minut. Nepovede-li se email z jakéhokoliv důvodu odeslat, zůstane uložen a bude v nastaveném intervalu (výchozí hodnota 10 minut) odesílán znova, dokud nebude úspěšně odeslán nebo nepřekročí počet pokusů o odeslání (výchozí hodnota 432). Po dosažení počtu pokusů o odeslání zůstane email v databázi pro případnou diagnostiku.

Nastavení odesílání je uloženo v databázi (tabulka tProperty):

Schránky elektronické pošty

Pokud chcete komponentou MailboxReader automaticky načítat obsah určité schránky elektronické pošty do určité služby service desku (viz Služby Service Desku), pak je třeba pro službu nastavit připojení k dané schránce.
Připojení se nastavuje v programu Admin.exe v části pro nastavení služeb příkazem Upravit – záložka Načítání zpráv. Pro čtení zpráv doporučujeme použití protokolu IMAP.

Uživatelská pravidla

MailboxReader může provádět akce na základě uživatelsky definovaných pravidel. Uživatelská pravidla se nastavují v programu MailboxReaderAdmin.exe.

Sekce applicationSettings

Další nastavení jsou uložena v sekci:

<configuration>
 <applicationSettings>
  <Alvao.Hd.MailboxReader.Properties.Settings>

Protokol událostí

Protokol událostí lze nastavit v sekci:

<configuration>
 <system.diagnostics>
  <switches>
   <add name="GeneralTraceLevel" value="0" />

Jako value můžete nastavit jednu z následujících hodnot:

Přitom platí, že vypisuje zvolenou úroveň a všechny nižší. Například když nastavíme hodnotu "2", budou se vypisovat varování a chyby.

Diagnostika odesílání

Pokud se nepovede odeslání emailu, vypíše komponenta MailboxReader na svůj výstup chybové hlášení obsahující informace o odesílaném emailu a text nastalé chyby. Toto hlášení se vypisuje při nastavení protokolu událostí na úroveň 2 a vyšší. Pro hlášení informující o obecném selhání komponenty (např. neplatná operace s databází) stačí nastavení protokolu událostí na úroveň 1.

V případě, že se v databázi nachází zprávy, které dosáhly maximálního počtu pokusů o odeslání, je na výstup jednou denně vypsáno hlášení o počtu zpráv, které nebylo možno odeslat (Protokol událostí úrovně 1 a vyšší):

"The mail queue currently contains X emails that could not have been sent."

Neodeslané emaily lze najít v databázi (tabulka  MailMessage), kde se kromě samotné zprávy (zabalené ve formátu .eml) nachází i informace o počtu pokusů o odeslání (SendAttempts), poslední chybové hlášení (LastErrorMsg) a čas posledního pokudu o odeslání (LastAttemptTime).

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.