Skip Navigation LinksALVAO 11.0ALVAO Service DeskImplementace systému v organizaciInstalaceALVAO Server - ruční instalaceNastavení součásti MailboxReader Skip Navigation Links.


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í WebApp.
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í WebApp, viz Připojení k databázi.

Odesílání e-mailů

Komponenta MailboxReader odesílá veškeré emailové zprávy odcházející ze systému Alvao. Adresu SMTP serveru pro odesílání zpráv elektronické pošty v databázi je potřebné nastavit v WebApp - Správa - Nastavení - Odesílání zpráv.

Emaily jsou odesílány v dávkách, výchozí interval odesílání je 1 minuta. 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):

Proměnná Výchozí hodnota Význam
MailSendIntervalSeconds 60 Interval odesílání emailů - ve vteřinách
MailSendMaxAttempts 432  Maximální počet pokusů o odeslání emailu
MailSendRetryIntervalMinutes 10 Interval mezi pokusy o opětovné odeslání emailů, které se nepodařilo odeslat - v minutách

Změna intervalu odesílání emailů se projeví až po restartování MailboxReaderu.

Schránky elektronické pošty

Pokud chcete zprávy z určité schránky elektronické pošty automaticky načítat do určité služby service desku (viz Služby Service Desku), v WebApp - Správa - Služby - Upravit – sekce Načítání zpráv nastavte připojení k dané schránce.

Pravidla pro příchozí zprávy

MailboxReader může provádět akce na základě definovaných pravidel. Pravidla pro příchozí zprávy se nastavují v WebApp - Správa - Service Desk - Pravidla pro příchozí zprávy.

Automatické odpovědi

Pokud při načítání zpráv MailboxReader narazí na zprávu, která je vyhodnocena jako automatická odpověď, neuvažuje se tato zpráva za plnohodnotnou zprávu a nejsou proto případně provedeny následující operace:

Za automatickou odpověď se uvažují zprávy, které:

  • v hlavičce obsahují parametr Auto-Submitted s hodnotou auto-generated, auto-replied nebo auto-notified nebo
  • v předmětu zprávy obsahují jeden z předdefinovaných řetězců.

Nastavení

Pokud si přejete změnit výchozí nastavení předdefinovaných řetězců, které jsou obsaženy v předmětu automatických odpovědí ve vaší organizaci, upravte a spusťte na databázi Alvao následující SQL příkaz. update tProperty set sPropertyValue = N'Automatická odpověď*;Automatic reply*;Mimo kancelář*;Out of Office*' where sProperty = 'AutoSubmittedEmails.Subjects'

Poznámka:
V příkladu je uvedeno výchozí nastavení. Jednotlivé šablony předmětů jsou odděleny středníkem, hvězdička nahrazuje libovolný počet jakýchkoliv znaků.

Ve výchozím nastavení je rozpoznávání automatických odpovědí zapnuté. Pokud si nepřejete tuto funkčnost používat, spusťte na databázi Alvao následující SQL příkaz: update tProperty set bPropertyValue = 0 where sProperty = 'AutoSubmittedEmails.Detect'

Sekce applicationSettings

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

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

Proměnná Hodnota
SleepSeconds Doba, po kterou MailboxReader čeká, pokud v poštovní schránce nejsou žádné nové zprávy. Doba se zadává v sekundách.
AutoAnswerTicketPerDayLimit MailboxReader přestane odesílat žadateli automatické odpovědi na nové požadavky, pokud počet přijatých požadavků od daného žadatele za posledních 24 hodin překročí nastavený limit.

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:

Hodnota Popis
0 Vypnuto - nevypisuje nic
1 Výpis chyb
2 Varování
Informativní
4 Upovídaný - vypisuje vše. Tato hodnota je nastavena v konfiguračním souboru jako výchozí. 

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 pokusu o odeslání (LastAttemptTime).

 

 

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