IMAP(S) (mail)
Settings
(1) Channel selection: "Mail" channel that can be used to connect to the server and pick up the emails (fetching channel). Note: For IMAPS (port 993) you have to select a channel.
(2) Mail server: URL/IP address and port of the mail server, as well as user and password. If these fields are left empty, the values are taken from configuration file ./etc/startup.xml. In that case, the values for user and password are taken from the configuration file as well and the values in the respective fields are ignored. Note: If a channel is selected and value 0 is set for the port, the port specified in the channel will be use used instead. If a value > 0 is set, this value will be used.
(3) IMAP directory: Name of the IMAP directory from which the emails are to be read. Only emails from this directory will be read. Any existing subdirectories are not taken into account. To fetch the emails from the inbox of the user account, the value INBOX must be entered in the field. In order to fetch the emails from a subfolder of the inbox of the user account, the value INBOX/<name of the subfolder> must be entered. Note: Two profiles with identical directory details are considered equivalent in the profile scoring (regarding this point). If this is not desired, you can enter an empty string for one of the profiles.
(4) Move to: If an existing IMAP folder is entered here, fetched messages are not deleted, but moved to this folder.
(5) Use S/MIME operations: If set, received S/MIME emails will be decrypted, otherwise the emails will remain as received. See corresponding settings in section Mail (channel).
(6) Activate parallel processing: If this checkbox is set, several instances of the processing profile can work in parallel. Checkbox Profile may only run in one instance may then not be set for this profile. For details of the processing, see section Parallel processing of mails.
(7) Skip corrupt mail: If set, receiving a corrupt email will not cause the job to terminate (which it will if the checkbox is not set).
(8) Unknown mails: If no matching processing profile is found for an email (see following section), it will be moved to the Unresolved area or discarded. See also section Non-assignable emails.
Note: The syntax in (3) and (4) may differ depending on the server, e.g. INBOX/<name of the subfolder>. If tracing is enabled for the profile in the logging configuration of phase 1, a list of the supported folders is written into the log.
Distribution rules
See section Distribution rules (mail). If no rule is specified or if no rule applies, then the setting in (8) applies.
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.
The subject of an email can be accessed in the profile with VAR_MAILSUBJECT, the text of the body with VAR_SYS_MAIL_BODY and the IMAP directory from (2) with VAR_SYS_FILE_PATH.
See also VAR_SYS_ATTACHMENT_NAME.