Settings

(1) Channel selection: You can select a channel of type "Mail". If a channel is selected, its settings will be used. If no channel is assigned, the SMTP service settings of the Integration Server are used. Note: As background, it should be mentioned that every incoming email internally gets a channel ID assigned. A matching ID is the ID of a channel, whose "Own ID" (the own email address for a channel of type Mail) matches the receiver address of the incoming email and whose "Partner ID" (the email address of the partner for a channel of type Mail) matches the sender address of the incoming email. The internally determined channel ID is then compared with the ID of the channel selected here. See (2) and (3).

(2) Also applies to communication channels with the same own identifier: Normally, if a channel has been selected, only the emails corresponding to that channel will be accepted, see (1). However, it might be the case that a partner sends emails from different addresses, all of which should be accepted. Which means there will be several channels that have different partner addresses, but the same own address (local ID). If this checkbox is set, all emails assigned to channels that have the same local ID as the selected channel will be accepted. The forwarding of attachments that do not match the file name pattern in (10) to other profiles with the same channel will then be extended to profiles with channels that have the same local ID. Attention: If an email gets assigned to a channel, it will not be forwarded to a profile that does not have a channel, even if the address parameters directly set are correct.

(3) Ignore communication channel with received mail: The channel assigned to the received email is ignored, see (1) and (2).

(4) Recipient address: E-mail address of the recipient of the email. This field must have a value. Note: See also (1).

(5) Also check RcptTo address: If this checkbox is set, not only the To address but also the RcptTo address is considered.

(6) Sender address: This field is used to restrict the profile to specific senders. If the field is empty, the sender of the email will not be considered. If there is an entry, there is a check whether the sender of the email contains the character string entered in this field. That means it is sufficient, for example, to enter the domain of the sender's address in this field. Uppercase and lowercase are ignored. Multiple senders and regular expression are not allowed.

(7) Subject contains: This field is used to restrict the profile to specific subjects. If the field is empty, the subject of the email will not be considered. If there is an entry, there is a check whether the subject of the email contains the character string entered in this field. Uppercase and lowercase are ignored. Multiple subjects are not allowed. You can use a regular expression with prefix regex.

(8) Use mail body: If this checkbox is set, only the message text of the email (body) will be considered. The attachments of the email are ignored by the Input Agent, even if a file name pattern (10) has been specified. If the checkbox is not set, only the attachments of the email will be considered. The message text itself will then be ignored. Note: The system variable VAR_SYS_MAIL_BODY is filled with the content of the email body.

(9) MIME type mail body: The MIME type of the received message text. The default is text/plain for simple text emails. If the sender sends HTML emails, you can switch to text/html. An HTML email usually contains two bodies, an HTML text with MIME type text/html and a plain text with MIME type text/plain. See also (8).

(10) File pattern mail attachment: File name pattern. You can enter multiple file patterns separated by the pipe (|) character (e.g. *.txt|*.csv). The emails can contain any number of attachments, but any attachments that do not match the file pattern will be ignored.

Note: Occasionally, SMTP users may still be logged in when shutting down. Normally these connections are terminated and the SMTP service is shut down. However, if you do not want to stop SMTP sessions automatically, you can set this behaviour with option stopServices. The following listing shows the option in configuration file ./etc/startup.xml in section com.ebd.hub.datawizard.app.DataWizard. By default, this entry is commented out. Note: The option also applies to the FTP service.

System variables

Several system variables are available for received emails. Special mention should be made here of VAR_SYS_MAIL_HEADER_<name of the email header in capital letters>. Example: The variable VAR_SYS_MAIL_HEADER_DATE receives the original string value of the email header Date. The email header line Date: Wed, 6 Sep 2017 13:50:01 +0300 will result in the variable content Wed, 6 Sep 2017 13:50:01 +0300.

See also VAR_SYS_ATTACHMENT_NAME.

Activating SMTPS

See section SmtpService.