Sends a Unicode-encoded email or group of emails with file attachments to a designated set of recipients.
Specifying the text of an email
To send a simple email without attachments, type a subject line for the email in the MessageSubject property and type the main body of the email in the MessageBody property.
If the text that you want to include in the main body of the email is stored outside of the Send Email node, add an input to the Send Email node, then select the from Field variant of the MessageBody property and enter the name of the input field that contains the body text.
For example, if the body text is contained in a Create Data node in a field called "BodyText", you would enter BodyText in the from Field variant of the MessageBody property.
Attaching a file to an email
To attach a single file, enter the file path of the file that you want to attach in the FilesToAttach property.
To attach multiple files, add an input to the Send Email node to reference the files that you want to attach. Then, select the from Field variant of the FilesToAttach property and specify the name of the field that references the files that you want to attach. For example, if the Send Email node is connected to a Create Data node that lists the file paths of the files that you want to attach in a field named "FilePath", select the from Field variant of the FilesToAttach property, and then enter FilePath.
Specifying email recipients
To send the email to a single recipient, specify the recipient's email address in the ToAddress property.
To send the email to multiple recipients, enter a list of email addresses in the ToAddress property, separating each address with a comma. Or, to pull in a list of recipients from outside of the node, select the from Field variant of the ToAddress property and enter the name of the input field that contains the email addresses. For example, if you have a Create Data node that contains a list of email addresses in a field called "Recipient", you would select the from Field variant of the ToAddress property and then enter Recipient.
Properties
FromAddress
Specify the email address that will appear in the 'From' field of all emails sent by this node.
MessageSubject
Specify the text that will appear in the 'Subject' field of all emails sent by this node.
Choose the (from Field) variant of this property to look up the value from an input field with the name specified.
A value is required for this property.
ToAddress
Specify a comma-separated list of specific email addresses to which a single Email will be sent.
Choose the (from Field) variant of this property to look up rows of addresses from an input field with the name specified.
A value is required for this property.
CcAddress
Optionally specify a comma-separated list of specific email addresses to which a single Email will be sent as CC'd.
Choose the (from Field) variant of this property to look up rows of addresses from an input field with the name specified.
MessageBody
Specify the text to include in the email message body.
Choose the (from Field) variant of this property to look up a value from an input field with the name specified.
A value is required for this property.
FilesToAttach
Optionally specify the files to be added to the email as attachments. To attach multiple files a semicolon-separated list is required.
Choose the (from Field) variant of this property to look up rows of files from an input field with the name specified.
SmtpServerName
Specify the name of an open SMTP server that is visible to the application server, for example smtp.example.com.
A value is required for this property.
EncryptionType
Specify the SMTP server connection encryption type. Choose from:
- None
- TLS
- SSL
The default value is None.
SmtpServerPort
Optionally specify the port number used by the SMTP server.
The default value is 25, or 465 where SSL encryption is used.
Username
Optionally specify the username for the SMTP server.
Leave blank if not required.
Password
Optionally specify the password for the SMTP server.
Leave blank if not required.
EmailFormat
Optionally specify whether emails are sent as plain text or HTML. Choose from:
- PlainText
- HTML
The default value is PlainText.
HtmlMessageBody
Optionally specify HTML to include in the email message body.
Choose the (from Field) variant of this property to look up a value from an input field with the name specified.
If left blank, the plain text message specified in MessageBody will be used.
RefusedDestinationBehavior
Optionally specify how the Email Generator handles situations in which the destination email addresses are refused. Choose from:
- Error
- Log
- Ignore
The default value is Error.
SmtpServerConnectionTimeout
Optionally specify the maximum period (in seconds) to wait before the SMTP server connection attempt times out.
The default value is 60 seconds.
MaximumEmailsToSend
Optionally specify the maximum number of emails to be sent.
The default value is 100.
MaximumEmailsExceededBehavior
Optionally specify how the node handles situations in which the maximum number of emails it is configured to send is exceeded. Choose from:
- Error
- Log
- Ignore
The default value is Error.
Inputs and outputs
Inputs: 1 optional.
Outputs: None.