MailboxReader Component Settings

MailboxReader Component Settings

The settings are stored in the MailboxReader.exe.config file, which is located in the Bin folder. This file is based on XML and therefore the same rules apply to it as for the file Web.config; please refer to Portal Settings for more information.
Create the file by copying the file "Bin\MailboxReaderSample.exe.config". You can use Windows Notepad to edit this file.

Database connection

The database connection can be defined in the following section:

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

Enter the database connection string in the connectionString attribute. The string format is the same as in the Portal settings; please refer to Database connection for more information.

Sending of e-mails

The component MailboxReader v. 7.1 and later sends all outgoing e-mail messages from ALVAO. Before you can send e-mail messages, you will need use the Admin tool to set up the SMTP Server address in the database. To open the SMTP Server settings, go to the Manage – Settings menu.

E-mail messages are sent in batches, with the default sending interval set to 5 minutes. If an e-mail message cannot be sent for any reason, it will be saved and the attempt to send the message will be repeated in the specified period of time (10 minutes by default) until the message is sent successfully or until the maximum number of attempts is reached (432 attempts by default). Once the maximum number of failed attempts has been reached, the message will be stored in the database for diagnostic purposes.

The settings are stored in the database (the tProperty table):

Mailboxes

If you want to use the MailboxReader component to load the content of a certain mailbox automatically to a certain Service Desk service (see Service Desk Services), you need to set up the connection to this mailbox first.
To set up the connection, go to service settings section in Admin.exe and then click on Edit and select the Loading messages tab. We recommend using IMAP for reading messages.

User-defined rules

The MailboxReader component can preform various actions based on user-defined rules. These rules can be defined in MailboxReaderAdmin.exe.

applicationSettings section

Other settings are saved in the following section:

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

Event Log

The Event Log can be set up in the following section:

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

You can use the value attribute to set one of the following values:

The log will always record the selected level and all the levels below it. For example, if you use the "2" value, the log will record all warnings and errors.

Diagnostics of Failed Messages

If the sending of an e-mail message fails, MailboxReader will output an error message containing all information on the failed message as well as the error message text. The error message will be logged if you set the Event Log to level 2 or higher. If you set the Event Log to level 1, MailboxReader will still log messages on general failure of the component (e.g. invalid database operation).

If the database contains messages for which the maximum number of attempts has been reached, the component will save the report on the number of failed messages once per day (Event Log level 1 and higher):

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

Failed messages are saved in the database (MailMessage table) which – in addition to the message itself (packed in the .eml format) – also contains information on the number of send attempts, the last error message (LastErrorMsg), and the last attempt time (LastAttemptTime).

Did not find what you were looking for? Ask our technical support team.