FME Flow: 2024.2
Configuring the IMAP Publisher
- In the FME Flow Web User Interface, select Notifications > Publications, and click New.
- Provide a name for the Publication
- In the Protocol drop down menu, select Email (IMAP).
- Specify the Topics you want to publish to using the drop-down selector. To create a topic and use it right away, click +.
- IMAP Server Host: Provide the host name or IP address of the IMAP server.
- Gmail: imap.gmail.com
- 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.
- IMAP Email Account/Password: Provide the email address and password of the account receiving emails over IMAP.
- 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: If New Emails Only is selected, the publisher fetches only unread messages that were received after the last fetch. If Unread Emails is selected, the publisher fetches every unread email message in the in-box.
- 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 (optional): 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 (optional): 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 _.
- Client ID (optional): For open authorization (OAuth) as a registered application with the Microsoft identity platform, specify the Application (client) ID. The client ID is created when configuring an Azure Active Directory tenant.
- Click OK.
Common IMAP Server Host Names
Note IMAP access must be enabled in the account settings.
Default TCP Ports by Protocol
Protocol | Default TCP Port |
---|---|
SSL/TLS | 993 |
StartTLS | 143 |
None | 143 |
Note IMAP access must be enabled on this account.
Warning When the IMAP publisher polls the IMAP server, every unread email in the in-box is marked as read, regardless of this setting.
Note A client secret is not required.