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í |
| 3 |
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.