This deprecated node sends a Unicode-encoded e-mail or group of e-mails to a designated set of recipients.
This node can be used in two different modes:- Set-Recipient Mode: In this case, the "ToAddress" property contains a single e-mail address to which an e-mail or group of e-mails is sent. This mode could be used to mark that a data flow has completed running or to report the results of a long-running data flow.- Variable-Recipient, or Bulk, Mode: In this case, the "ToAddress" property contains the name of an input field, surrounded by single quotes, from which to fetch e-mail addresses. Each row of the column must contain a single e-mail address. For each row of input data, this node will send an e-mail to the address found in the specified field. This mode could be used to send summarized weekly usage statistics to various members of your team once the results are available.In each case, the user can place 'columnName' into the text of the ToAddress or the MessageBody in order to replace that text, single quotes and all, with the value from the specified column for that row of data.All text entered into this e-mail (body, subject, source and destination addresses) is converted to Unicode before sending.
Properties
SmtpServerName
Name of an open SMTP server that is visible to the BRAIN server. This STMP server must be listening on port 25.
FromAddress
The e-mail address that will appear in the 'From' field of all e-mail sent by this node.
MessageSubject
The text that will appear in the 'Subject' field of all e-mail sent by this node.
ToAddress
Either a semicolon-separated list of specific e-mail addresses to which to send a single e-mail or a column from which to receive e-mail addresses to which to send a message for that row. You can also mix the two formats.
For example, to send an e-mail for each row of input to the same two e-mail addresses, use the following entry:
mary.hunt@example.com; "Richard Rodriguez" <rrodrig@mda-data.com>
If you would like to have the destination e-mail address come from a field in the data, just type the field name enclosed in single quotes ('). Note that if the data field contains a list of e-mail addresses formatted as above, then each of those e-mail addresses will receive a message. To send an e-mail, one per row, to the addresses in the input field "toAddresses", use the following entry:
'toAddresses'
You can also mix these two approaches. For example, the send an e-mail for each input row to the department head and to send a section-specific e-mail only to that section leader, use the following entry:
deptMgr@mda-data.com; 'sectionLead'
Note that, if you use the '"Name" <email@addr.net>' format, you cannot have a semicolon in the Name portion.
MessageBody
Text to include in the e-mail message body.
The user can place 'columnName' into the text of the MessageBody in order to have that text be replaced, single quotes and all, with the value from the specified column.
RefusedDestinationBehavior
Defines how the E-mail Generator handles situations in which destination e-mail addresses are refused. The default is "Error".
Please note that an SMTP server may accept messages whose final destination address is invalid. In this case, the E-mail Generator node will pass, but the intended recipient will not receive an e-mail. Under these circumstances, most servers will send a delivery failure e-mail to the sender's e-mail address. Checking this e-mail address is crucial to knowing if all intended recipients received the e-mail message sent by this node.
This property may take the following values:
Error - After attempting to send an e-mail to every recipient e-mail address, the node fails. The log contains a list of every e-mail address that was refused.
Log - Writes a list of refused e-mail addresses to the log. The node passes as long as a single recipient receives an e-mail message.
Ignore - Ignores all refused e-mail addresses. There is no output written to the log. Like the "Log" option, the node will pass as long as a single recipient receives an e-mail message.
If all the e-mail addresses are refused, then this node will fail regardless of the setting of this property.
Inputs and outputs
Inputs: multiple optional.
Outputs: multiple optional.