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 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):
Proměnná |
Výchozí hodnota |
Význam |
MailSendIntervalSeconds |
300 |
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 |
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.
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 programu
Admin.exe v části pro nastavení pravidel příkazem
Spravovat - Pravidla pro příchozí zprávy.
Automatické odpovědi
Pokud při vyčí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 ALVAO databázi 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 ALVAO databázi
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í; |
3 |
Informativní; |
4 |
Upovídaný; vypisuje vše |
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.
|