Email - IMAP

Note: See also Working with Parameters in Automations Workflows.

Tip: To test that your parameters work as expected, click Validate.

• IMAP Server Host: Provide the host name or IP address of the IMAP server.
Common IMAP Server Host Names
• Gmail: imap.gmail.com

Note: IMAP access must be enabled in the account settings.

• Outlook (Live and Hotmail): imap-mail.outlook.com
• Yahoo: imap.mail.yahoo.com
• AOL: imap.aol.com
• IMAP Server Port: Provide the TCP port over which IMAP communication takes place.
Default TCP Ports by Protocol

Protocol	Default TCP Port
SSL/TLS	993
StartTLS	143
None	143

• IMAP Email Account/Password: Provide the email address and password of the account receiving emails over IMAP.

Note: IMAP access must be enabled on the email account that is polled for messages.

• Connection Security: Specify the encryption mechanism to use for the IMAP connection. The mechanism selected must work over the specified port.
• Verify SSL Certificate: If Yes, the connection to the specified IMAP Server Host is verified with a valid, signed SSL certificate. If No, the connection is not verified with an SSL certificate. This option is not secure and not recommended unless absolutely necessary, such as when using a self-signed certificate.
• Poll Interval: Specify how often to poll the IMAP server for email.
• Emails to Fetch: Choose New Emails Only to fetch messages that are received after this automation is created. Choose Unread Emails to fetch all unread messages from the inbox.

WARNING: When the Email - IMAP trigger polls the IMAP server, every unread email in the in-box is marked as read, regardless of this setting.

• Filter Type: Allows you to fetch only the messages specified by the filter, based on content in the subject line. Filter Type can be:
• Simple: A specified string (case-insensitive).
• Regex: A regular expression. For information about creating regular expressions, see https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html.
• Subject Filter: Provide the filter, according to the specified Filter Type. Wildcard characters are not supported. If blank, no filter is applied, and all unread/new messages are fetched.
• Download Attachments To: Specify a location to download any attachments.
  • Select a Resources folder (...).
  • Enter your own location. Directory paths must use forward slashes (/) or escaped backslashes (\\).

  If not specified, any attachments are saved to the following default temporary folder:

  $(FME_SHAREDRESOURCE_SYSTEM)/temp/emailattachments/<date>-<automation_name>-<email_subject>-<automation_id>\<filename>.

  If specified, the following subfolder is created in the specified location:

  <specifiedLocation>/<date>-<automation_name>-<email_subject>-<automation_id>/<filename>

  If <specifiedLocation> is invalid, attachments are saved to the default temporary folder.

  If <automation_name>, <email_subject>, or <filename> contains invalid characters, these characters are stripped. Invalid characters are \/:*?\"<>|&='+%#. Whitespace characters are converted to _.

See Also

• Working with Output Keys in Automations Workflows.