Send Mail
Description
Sends an e-mail message.
note
If a mail server returns the SMTP error "530 5.7.0 Must issue a STARTTLS command first", the activity will renegotiate the connection using STARTTLS and retry the send operation if StartTLSOption
= "Retry" was specified.
Assembly: iCore.Workflow.Activites
Category: Misc
Arguments
Authentication
Authentication can be done either with basic or so-called modern authentication.
note
Currently, modern authentication can only be used with Microsoft Office 365.
Basic authentication
Name | Type | Description |
---|---|---|
Password | String | The password used to log-in on to the server. |
Port | Int32 | The SMTP server port. Default: 25. |
Server | String | The SMTP server to use for sending the mail. Can be either:
|
SSL/TLS version | SslVersions | SSL/TLS version to be used. More than one option can be selected. Default is TLS 1.3, TLS 1.2. For more information, see General information about SSL and TLS. |
StartTlsOption | StartTlsOption | Specifies how Start TLS will be used. |
Username | String | The user name used to log-in on to the server. |
Modern authentication
important
When using modern authentication, the Server
parameter listed under Basic authentication needs to be set to Auto:Modern-MicrosoftOffice365
. The other parameters in that section can be disregarded.
note
Modern authentication requires either a client secret or a certificate. Consequently, it is enough to set one of the parameters Client secret
or Certificate
. If both are set, the certificate option is selected.
For more information, see Authentication in mail clients using Microsoft Office 365.
Name | Type | Description |
---|---|---|
Account name | String | The account name of the user. |
Certificate | ICertificate | The certificate used to authenticate the client. Can be used instead of client secret. |
Client Id | String | The identifier for the Azure AD client (application) used for authentication. |
Client secret | String | The client secret used to authenticate the client. |
Tenant Id | String | Tenant Id of the Azure Active Directory. |
Delivery status notification
note
When the activity is configured to use a Microsoft Exchange Online mail server (Office 365) with modern authentication, only the Notify
parameter value "DSNOptions.Success" is taken into account. Segment
and EnvelopeId
will not have any effect.
Name | Type | Description |
---|---|---|
Envelope Id | String | The Envelope Id to be included in the return message header. |
Notify | DSNOptions | The Delivery Status Notification requested for the message. |
Segment | DSNSegment | The Delivery Status Notification segment to return. |
Standard
Name | Type | Description |
---|---|---|
Attachments | IEnumerable<Attachment> | The files to attach. |
Bcc | String | The e-mail address of the BCC recipient of the message. If there are multiple addresses, they are to be separated by ";" (semicolon). |
Cc | String | The e-mail address of the CC recipient of the message. If there are multiple addresses, they are to be separated by ";" (semicolon). |
From | String | The e-mail address of the sender of the message. |
MailBody | String | The body text to be placed in the message. |
Subject | String | The subject of the message. |
To | String | The e-mail address of the recipient of the message. If there are multiple addresses, they are to be separated by ; (semicolon). |