Mail receive is a producer that retrieves email messages from a POP3 and IMAP email server (so that users can access e-mail accounts like Gmail, Hotmail etc) and injects any file attachments into the flow. Please note that Switch only accepts MIME encoded attachments.
Keywords
If you enter one of the following keywords in the Search field at the top of the Flow Elements pane, the Mail receive element will be shown in the list:
- Internet
- web
- POP3
- IMAP
- network
- communication
- transfer
- input
Connections
Mail receive does not allow incoming connections.
Mail receive allows only a single outgoing connection.
Properties
|
Property |
Description |
|---|---|
|
Name |
The name of the flow element displayed in the canvas. |
Description |
A description of the flow element displayed in the canvas. This description is also shown in the tooltip that appears when moving your cursor over the flow element. |
|
Server type |
The type of server from which to retrieve mail. Choices are POP3 and IMAP4. |
|
Server address |
The URL or IP address of the server from which to retrieve mail. |
| Port | Editors in this property are numbers and it is empty by default. |
|
Accounts |
A list of accounts (names and corresponding passwords) from which to retrieve mail. |
|
Use secure password verification |
Defines whether to log in to the mail server using secure password verification. |
|
Server requires secure connection (SSL) |
Defines whether the mail server requires a secure connection using the SSL protocol. |
|
Leave originals on server |
If set to Yes, incoming messages are left untouched on the server. If set to No (default value), incoming messages are removed from the server; see also Leaving originals in place. |
|
Check every (minutes) |
The frequency of checking the e-mail accounts for new messages. |
|
Time-of-day window |
If set to Yes, the tool checks for new arrivals only during a certain time of the day (specified in the subordinate properties). |
|
Allow from (hh:mm) |
The time-of-day window during which to check for new arrivals; the values are structured as "hh:mm" (hours, minutes) indicating a time of day on a 24 hour clock; an empty value means midnight; two identical values mean the tool always checks for new arrivals. |
|
Allow to (hh:mm) |
|
|
Day-of-week window |
If set to Yes, the tool checks for new arrivals only during certain days of the week (specified in the subordinate properties). |
|
Allow from |
The days of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday) during which to check for new arrivals; two identical values mean the tool only checks for new arrivals on that specific day. |
|
Allow to |
|
|
Day-of-month window |
If set to Yes, the tool checks for new arrivals only during a certain day of the month (specified in the subordinate properties). |
|
Day |
The day in the month during which to check for new arrivals, as a number in the range [1 . . 31]; the default value of one means the first or the last day of the month (depending on the following property). |
|
Relative to |
Determines whether the day of the month is relative to Start of month' or End of the month. |
|
Attach hierarchy info |
If set to Yes, information about a file's origin (derived from the e-mail message as specified by the next property, see below) is added to its internal job ticket as a location path; see Using hierarchy info for more details. |
|
Base info on |
Defines how to derive the attached location path from the email message; the path can be based on the contents of one of the following: "Sender's email address", "Email account name", or "Message subject". |
|
Attach email info |
If set to Yes, the sender's address of the incoming email message is added to the e-mail information in the file's internal job ticket; body text from the incoming message is never copied into the e-mail info; see Using Email info for more details. |
|
Attach extra email info |
If set to Yes, additional e-mail info is added to the internal job ticket as specified by the next two properties (see below); the information added can vary depending on properties of the incoming e-mail message (see below); see Using Email info for more details. |
| Base map key on |
Defines the "key" that is used to select the appropriate email info from the table provided in the next property; the key can be contents of: "Sender's email address", "Email account name", or "Message subject". |
| Email info map |
E-mail addresses and body text specified with the editor for this property are added to each file's email info as the file is injected in the flow; the value of the key specified in the previous property (for example, the sender's address of the incoming email message) determines which entry of the table is actually added. |
| Scan for nested attachments | When set to Yes, user can scan all nested e-mail until no e-mails but real assets are found. The default value is No. |
| Collect attachments | Set to Yes to collect all attachments in a folder. Single file attachments will also be stored in a job folder. The default value is No. |
| Assemble message and attachments | This is a sub property of Collect attachments and is available only when the parent is set to Yes. Set to Yes to assemble the injected message and the attachment(s) in the same job folder. If there is no message to inject, this property will not affect attachment handling. The default value is No. |
| Inject message as file |
Determines whether the e-mail message itself (as opposed to its attachments) is injected into the flow as a separate file; choices are:
|
| Convert HTML to plain text | This property is only available if Inject message as file is set to If no attachments or Always. If set to Yes, the HTML message body will be converted to plain text and saved as a .txt file with UTF8 encoding.If set to No, the message body will not be converted; it is injected into the flow in the original format: (rich) text remains (rich) text, HTML remains HTML. Note: The file will be named after the subject line of the
e-mail message. If there is no subject line, the file will
be named "No subject.txt" or "No subject.htm".
|
Picking up e-mail metadata
The Mail receive tool automatically picks up the contents of incoming e-mail messages as metadata. This behavior cannot be configured or turned off (that is, there are no flow element properties related to this behavior). See Picking up metadata for more background information.
For each incoming message the Mail receive tool creates a metadata dataset that contains the relevant components of the message, such as the sender, to, cc, and reply-to addresses and the complete e-mail body text. This dataset is then associated with the job ticket for all files delivered by the message under the standard dataset name "Email".
Refer to Email message schema for details on the format of the generated metadata.