Email Receive Connector

Version 21.0.8222


Email Receive Connector


The Email Receive Connector supports retrieving messages from an IMAP mail server.

概要

The Email Receive Connector provides a simple way to automate the process of receiving emails. The connector connects to a specified IMAP server and polls a specified mailbox for new messages to process. By default the connector only receives messages that have not yet been processed, and supports additional IMAP filters.

The connector supports receiving entire messages in EML format, or only downloading attachments on the emails to be processed.

Connector Configuration

This section contains all of the configurable connector properties.

Settings Tab

IMAP Connection

Settings related to establishing the connection to the IMAP server.

  • Connector Id The static name of the connector. All connector-specific files are held in a folder by the same name within the Data Directory.
  • Connector Description An optional field to provide free-form description of the connector and its role in the flow.
  • ホスト The hostname or IP address of the IMAP server.
  • ポート The port on which to connect to the IMAP server.
  • ユーザー The username credential to login to the IMAP server.
  • パスワード The password credential to login to the IMAP server.
  • メールボックス The IMAP mailbox to poll for messages.
  • SSL の種類 How to negotiate SSL/TLS when connecting to the server.’Explicit’ に設定すると、プレーンテキスト接続が確立され、その後明示的なコマンドでSSL/TLS が開始されます。When set to ‘Implicit’, SSL/TLS will immediately be negotiated without first establishing a plaintext connection.
  • ダウンロードの種類 Whether to download full messages in EML format or only email attachments.

Automation Tab

Automation Settings

Settings related to the automatic processing of files by the connector.

  • 受信 Whether the connector should automatically poll the remote mailbox for messages to download.
  • 受信間隔 The interval between automatic download attempts.
  • The number of minutes to wait before downloading. Only applicable when 受信間隔 is set to Minute.
  • 毎時何分 The minutes offset for an hourly schedule. Only applicable when 受信間隔 is set to Hourly. For example, if this value is set to 5, the automation service will download at 1:05, 2:05, 3:05, etc.
  • The time within a given day that the download should occur. Only applicable when 受信間隔 is set to Daily, or Weekly, or Monthly.
  • The day on which the download should occur. Only applicable when 受信間隔 is set to Weekly or Monthly.
  • Cron 式 An arbitrary string representing a cron expression that determines when the download should occur. Only applicable when 受信間隔 is set to Advanced.

Advanced Tab

Other Settings

Settings not included in the previous categories.

  • ログレベル The verbosity of logs generated by the connector. When requesting support, it is recommended to set this to Debug.
  • 検索する日数 The connector will automatically filter out messages it has received before. The first time the connector runs, however, it will process messages that were received within the number of days set in this field.
  • ** Additional IMAP filters for receiving messages. By default the connector already filters for messages it has not processed before.
  • IMAP ヘッダー A comma-delimited list of headers from the IMAP message that should be promoted as metadata in the downloaded file.
  • 受信サーバーパブリック証明書 If the IMAP server is an SSL server, this field should be set to the SSL Certificate that identifies the server. If the server’s certificate is not available, this field can be set to ‘Any Certificate’ to implicitly trust the server’s identity.
  • 親コネクタ The connector from which settings should be inherited, unless explicitly overwritten within the existing connector configuration. Must be set to a connector of the same type as the current connector.
  • Log Subfolder Scheme Instructs the connector to group files in the Logs folder according to the selected interval. For example, the Weekly option instructs the connector to create a new subfolder each week and store all logs for the week in that folder. The blank setting tells the connector to save all logs directly in the Logs folder. For connectors that process many transactions, using subfolders can help keep logs organized and improve performance.
  • Log Messages Whether the log entry for a processed file will include a copy of the file itself.
  • Save to Sent Folder Whether files processed by the connector should be copied to the Sent folder for the connector.

Miscellaneous

Settings for specific use cases.

  • Other Settings Allows configuration of hidden connector settings in a semicolon-separated list, like setting1=value1;setting2=value2. Normal connector use cases and functionality should not require use of these settings.

Establishing a Connection

The following settings are required to establish a network-level connection to the IMAP server:

  • ホスト:
  • Port
  • SSL の種類

The Test Connection button can verify that the connector can reach the server.

Once network-level connectivity has been established, the following settings are required to access the messages stored on the IMAP server:

  • User
  • Password
  • メールボックス

Receiving Emails

If 受信オートメーション is enabled, the Email Receive Connector will automatically poll the configured IMAP mailbox for messages to download. By default, the connector will only receive messages it has not already downloaded. The first time the connector receives messages, however, the range of messages to download needs to be specified via the 検索する日数 setting.

Messages can be manually retrieved by clicking the Receive button in the Output tab of the connector.

The ダウンロードの種類 setting determines whether the full messages or just the message attachments will be downloaded. Files that are downloaded are placed in the Output/Receive Folder or passed along to the next connected connector in the flow.

Search Filters

The ** setting allows for further customization of the range of messages to retrieve. This field accepts standard IMAP protocol filters and will only download messages that match the configured filters.

The following filters are supported:

<message set> Messages with message sequence numbers corresponding to the specified message sequence number set
ALL All messages in the mailbox - this is the default initial key for AND-ing.
ANSWERED Messages with the \Answered flag set.
BCC <string> Messages that contain the specified string in the envelope structure's BCC field.
BEFORE <date> Messages whose internal date is earlier than the specified date.
BODY <string> Messages that contain the specified string in the body of the message.
CC <string> Messages that contain the specified string in the envelope structure's CC field.
DELETED Messages with the \Deleted flag set.
DRAFT Messages with the \Draft flag set.
FLAGGED Messages with the \Flagged flag set.
FROM <string> Messages that contain the specified string in the envelope structure's FROM field.
HEADER <field-name> <string> Messages that have a header with the specified field-name (as defined in [RFC-822]) and that contains the specified string in the [RFC-822] field-body.
KEYWORD <flag> Messages with the specified keyword set.
LARGER <n> Messages with an RFC822. SIZE larger than the specified number of octets.
NEW Messages that have the \Recent flag set but not the \Seen flag. This is functionally equivalent to "(RECENT UNSEEN)".
NOT <search-key> Messages that do not match the specified search key.
OLD Messages that do not have the \Recent flag set. This is functionally equivalent to "NOT RECENT" (as opposed to "NOT NEW").
ON <date> Messages whose internal date is within the specified date.
OR <search-key1> <search-key2> Messages that match either search key.
RECENT Messages that have the \Recent flag set.
SEEN Messages that have the \Seen flag set.
SENTBEFORE <date> Messages whose [RFC-822] Date: header is earlier than the specified date.
SENTON <date> Messages whose [RFC-822] Date: header is within the specified date.
SENTSINCE <date> Messages whose [RFC-822] Date: header is within or later than the specified date.
SINCE <date> Messages whose internal date is within or later than the specified date.
SMALLER <n> Messages with an RFC822. SIZE smaller than the specified number of octets.
SUBJECT <string> Messages that contain the specified string in the envelope structure's SUBJECT field.
TEXT <string> Messages that contain the specified string in the header or body of the message.
TO <string> Messages that contain the specified string in the envelope structure's TO field.
UID <message set> Messages with unique identifiers corresponding to the specified unique identifier set.
UNANSWERED Messages that do not have the \Answered flag set.
UNDELETED Messages that do not have the \Deleted flag set.
UNDRAFT Messages that do not have the \Draft flag set.
UNFLAGGED Messages that do not have the \Flagged flag set.
UNKEYWORD <flag> Messages that do not have the specified keyword set.
UNSEEN Messages that do not have the \Seen flag set.