Send Mail

Send Mail is a synchronous activity that sends an email by way of an SMTP server.

General

The General tab has the following fields.

Field	Literal Value/Module Property	Description
Name	None	The name to be displayed as the label for the activity in the process.
SMTP Property	Yes	The property name of the SMTP server. If your server is configured for using a different port, specify it in this field.

Description

Provide a short description for the Send Mail activity.

Advanced

The Advanced tab has the following fields.

Field	Description
Allow Non-Standard Email IDs	By default, email IDs specified in the to, from, cc, bcc, or replyTo input elements must conform to the RFC 822 standard for email addresses. Select this checkbox to specify email IDs that do not conform to the RFC 822 standard. This is useful for sending mail to a server that has extensions for sending email to devices such as a fax machine. For more information about email address syntax, see http://www.faqs.org/rfcs/rfc822.html. Note: When this field is not selected, not all of the RFC 822 syntax rules are enforced. For example, addresses composed of simple names (with no "@domain" part) are allowed. For more information about enforcing RFC 822, see the description of the strict flag of the parse method of javax.mail.internet.InternetAddress at https://docs.oracle.com/.

Field

Description

Allow Non-Standard Email IDs

By default, email IDs specified in the to, from, cc, bcc, or replyTo input elements must conform to the RFC 822 standard for email addresses.

Select this checkbox to specify email IDs that do not conform to the RFC 822 standard. This is useful for sending mail to a server that has extensions for sending email to devices such as a fax machine.

For more information about email address syntax, see http://www.faqs.org/rfcs/rfc822.html.

Note: When this field is not selected, not all of the RFC 822 syntax rules are enforced. For example, addresses composed of simple names (with no "@domain" part) are allowed.

For more information about enforcing RFC 822, see the description of the strict flag of the parse method of javax.mail.internet.InternetAddress at https://docs.oracle.com/.

Input Editor

You may want to add custom headers to outgoing mail messages. From the Input Editor tab you can define a custom schema for the headers of the outgoing mail message. You can specify any standard header supported by the javax.mail package. For example, X-Mailer or X-Priority.

Input

The following is the input for the activity.

Input Item	Datatype	Description
username	string	The username to use when authenticating to the mail server.
password	string	The password to use when authenticating to the mail server.
from	string	The email address of the sender.
to	string	The recipient list for the email. Use this repeatable element to send mail to more than one recipient. Provide a list of "to" recipients in a single string by using either a comma or a semicolon (but not both in the same string) as delimiters.
cc	string	The "cc" (carbon copy) list for the email. Use this repeatable element to place more than one recipient on the "cc" list, if required. Provide a list of "cc" recipients in a single string by using either a comma or a semicolon (but not both in the same string) as delimiters.
bcc	string	The "bcc" (blind carbon copy) list for the email. Use this repeatable element to place more than one recipient on the "bcc" list. Provide a list of "bcc" recipients in a single string by using either a comma or a semicolon (but not both in the same string) as delimiters.
replyTo	string	The "replyTo" list for the email. Use this repeatable element to place more than one recipient on the "replyTo" list. Provide a reply to list in a single string by using either a comma or a semicolon (but not both in the same string) as delimiters to separate the addresses in the list.
subject	string	The subject of the email.
sentdate	string	The date stamp for the email. Note: The email server provides the actual date stamp for the email, so this input item is ignored. Do not attempt to place a value in this input item.
bodyElement	complex	Contains a choice element. You can provide the bodyText element.
bodyText	string	The text of the email message.
Headers	complex	Contains the schema you defined on the Input Editor tab. Specify custom headers for the outgoing mail messages. Specify any standard header supported by the javax.mail package. For example, X-Mailer or X-Priority. To use attachments, specify the Content-Type header as multipart/* (where * is a valid subtype of the multipart).
contentType	string	The mime content type for the message. You can specify a character encoding in this element for the encoding of the body of the message.
mimeEnvelopeElement	complex	Contains the message attachments.
mimePart	complex	This repeating element comprises each mime attachment.
mimeHeaders	complex	This element contains the mime header for each mimePart. mimeHeaders contain the following information: Content-type Content-transfer-encoding Content-id Any element For more information about MIME headers and their syntax, see http://www.faqs.org/rfcs/rfc2045.html. Note: When the contentType is specified as "text/" (for example, "text/xml"), specify the attachment content inthe textContent input element. When the contentType is anything other than "text/": The attachment content must be in the binaryContent input element.
binaryContent \| textContent	choice	This element contains the mime attachment. It can be any of the following: binaryContent: the content of the attachment when the attachment is binary data. textContent: the content of the attachment when the attachment is text data.

Fault

The Fault tab lists the possible exceptions generated by this activity.

Fault	Generated When..
InvalidInputException	The input is not valid.
UnknownHostException	The mail server host name is not resolved. The exception contains the name of the mail server host.
SendFailedException	The send operation failed for some reason.