IMAP(S) (mail)

Settings

① Channel selection: Channel of type Mail that connects to the server to retrieve the emails (fetching channel). For IMAPS (port 993), you must select a channel.

② Mail server: URL/IP address and port of the mail server, plus user and password. If these fields are empty, the system uses the values from the configuration file ./etc/startup.xml. This also applies to user and password. Values entered in these fields are then ignored. If a channel is selected and the port is 0, the port from the channel applies. For a port greater than 0, that value applies.

③ IMAP directory: Name of the IMAP directory the profile reads the emails from. It reads emails from this directory only and ignores any subdirectories. For the inbox of the user account, enter INBOX. For a subfolder of the inbox, enter INBOX/<name of the subfolder>. Two profiles with identical directory details count as equivalent on this point in the profile scoring. To avoid this, enter an empty string for one of the profiles.

④ Move to: Enter an existing IMAP folder here, and the system moves the fetched messages to that folder instead of deleting them.

⑤ Use S/MIME operations: If the checkbox is set, the system decrypts received S/MIME emails. Otherwise, the emails remain as received. See the corresponding settings in section Mail (channel).

⑥ Activate parallel processing: If this checkbox is set, several instances of the processing profile can work in parallel. The checkbox Profile may only run in one instance must not be set for this profile. For details, see section Parallel processing of mails.

⑦ Skip corrupt mail: If the checkbox is set, the system continues receiving after a corrupt email. Otherwise, the job terminates.

⑧ Unknown mails: If the system finds no matching processing profile for an email (see the following section), it moves the email to the Unresolved area or discards it. See also section Non-assignable emails.

NOTE: The syntax for ③ and ④ can differ depending on the server. Enable tracing for phase 1 in the profile's logging configuration, and the system writes a list of the supported folders to the log.

Distribution rules

See section Distribution rules (mail). If no rule is specified or no rule applies, the setting in ⑧ applies.

System variables

Several system variables are available for received emails. VAR_SYS_MAIL_HEADER_<name of the email header in capital letters> deserves special mention. 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 results in the variable content Wed, 6 Sep 2017 13:50:01 +0300.

Further variables in the profile:

• VAR_MAILSUBJECT contains the subject of the email.

• VAR_SYS_MAIL_BODY contains the text of the body.

• VAR_SYS_FILE_PATH contains the IMAP directory from ③.

See also VAR_SYS_ATTACHMENT_NAME.

NOTE: The system variable VAR_SYS_MAIL_HEADER_RECEIVED contains only the first “Received” mail header. To get all of them, use VAR_SYS_MAIL_HEADER_RECEIVED_ALLB64. This variable contains all Received mail headers, comma-separated and encoded in Base64.