Email - Send message

Declaration

<AMEMAIL ACTIVITY="send" SESSION="text" PROTOCOLTYPE="text (options)" AUTODISCOVERURL="YES/NO" USEHTTP="YES/NO" SERVER="text" PORT="number" DISABLECHUNKING="YES/NO" AUTHTYPE="text (options)" USERNAME="text" PASSWORD="text (encrypted)" DOMAINNAME="text" SECURITY="text (options)" CERTIFICATE="text" CERTIFICATEPASSPHRASE="text (encrypted)" IGNOREINVALIDCERTIFICATE="YES/NO" IMPERSONATE="YES/NO" TLSCIPHERS="text (options)" TLSVERSIONS="text (options)" TENANTID="text (encrypted)" CLIENTID="text (encrypted)" CLIENTSECRET="text (encrypted)" PROXYTYPE="text (options)" PROXYSERVER="text" PROXYPORT="number" PROXYUSERNAME="text" PROXYPASSWORD="text (encrypted)" FROM="text" TO="text" SUBJECT="text" BODY="text" BODYFILE="text" HTML="YES/NO" ATTACH="text" CC="text" REPLYTO="text" BCC="text" XMAILER="text (options)" PRIORITY="text (options)" SENSITIVITY="text (options)" REQUESTDELIVERYREPORT="YES/NO" CUSTOMHEADERS="text;text" RESULTDATASET="text" />

Related Topics

Description

Sends an email message with or without attachments to the specified recipient by way of SMTP, Microsoft Exchange 2003 (WEBDAV), Exchange 2007 (EWS), Exchange 2010 (EWS), or Exchange Online (EWS) protocol. This action supports Explicit and Implicit Transport Layer Security (TLS) and Secure Sockets Layer (SSL) security. It also supports the options to send plain text or HTML-formatted emails, the use of file contents as the email body, and the ability to request delivery reports and read receipts (if the recipient's email program supports delivery reports and/or read receipts).

Practical Usage

Used to send a plain text or HTML-formatted email with or without attachments using SMTP or Microsoft Exchange Server protocols. System administrators frequently use this activity to perform system notifications or conveniently package data retrieved from any other source such as databases or web sites.

Parameters

Connection

Property Type Required Default Markup Description
Connection --- --- --- --- Indicates where user credentials, server settings, and other preferences required to establish a connection to the email server originate. The available options are:
  • System (default) - Specifies that user credentials, server settings, and advanced preferences are obtained from a preconfigured properties set by way of the system.
  • Host - Specifies that user credentials, server settings, and advanced preferences are configured individually for this activity. This option is normally chosen if only a single activity is required to complete an operation.
  • Session - Specifies that user credentials, server settings, and advanced preferences are obtained from a preconfigured session created in an earlier step with the use of the Email - Create session activity. This option is normally chosen if a combination of related activities is required to complete an operation. Linking several activities to a single session eliminates redundancy. Additionally, a single task supports construction and simultaneous execution of multiple sessions, improving efficiency.
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.

Connection - Session

Property Type Required Default Markup Description
Session Text Yes, if Connection is set to Session EmailSession1 SESSION="emailSess1" The existing Email-based session to use with this activity. The default value is EmailSession1. This parameter becomes available and is required if the Connection parameter is set to Session.

Connection - Host > Server

Property Type Required Default Markup Description
Protocol Text (options) Yes SMTP
  • PROTOCOLTYPE="webdav"
  • PROTOCOLTYPE="ews"
  • PROTOCOLTYPE="ewsonline"
 Specifies the protocol to use to connect to the email server. The available options are:
  • SMTP (default) - Uses the Simple Mail Transfer Protocol (SMTP).
  • WEBDAV (Exchange 2003, 2007) - Uses the Web Distributed Authoring and Provisioning (WEBDAV) protocol. Compatible with Microsoft Exchange Server 2003 and Exchange Server 2007.
  • EWS (Exchange 2007 & newer, Online) - Uses the Exchange Web Services (EWS) protocol. Compatible with Microsoft Exchange Server 2007 and newer versions, and Exchange Online.
  • EWS Online - Uses the EWS protocol to access Microsoft Exchange Online by way of Modern Authentication.
If the Protocol parameter is set to SMTP, refer to these parameters.
Server Text Yes (Empty) SERVER="mail.server.com" Specifies the SMTP server address to use with the connection.
Port Number Yes 25 PORT="3333" The port to use to connect to the SMTP server. Most SMTP servers run on port 25 (default) however, this parameter can be customized to connect to another port.
Security Text (options) Yes No security
  • SECURITY="EXPLICIT"
  • SECURITY="IMPLICIT"
 Specifies the type of security to use with SMTP. The available options are:
  • No Security (default) - No security is used.
  • Explicit TLS/SSL - Uses Explicit Transport Layer (TLS) and Secure Sockets Layer (SSL) security.
  • Implicit TLS/SSL - Uses Implicit Transport Layer (TLS) and Secure Sockets Layer (SSL) security.
Use authentication --- --- Selected --- If selected (default), authentication takes place during the transmission.
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.
Authentication Type Text (options) Yes, if Use authentication is selected Auto
  • AUTHTYPE="plain"
  • AUTHTYPE="DigestMD5"
  • AUTHTYPE="CramMD5"
  • AUTHTYPE="Login"
  • AUTHTYPE="Ntlm"
  • AUTHTYPE="GssApi"
  • AUTHTYPE="OAuth20"
 Specifies the authentication protocol to use. This parameter is only available and required if the Use authentication parameter is selected. The following options are:
  • Auto (default) - Automate automatically determines the authentication type to use.
  • Plain - Authentication is through the PLAIN protocol.
  • DigestMD5 - Authentication is through the DIGEST-MD5 protocol.
  • CramMD5 - Authentication is through the CRAM-MD5 protocol.
  • Login - Authentication is through the LOGIN protocol.
  • Ntlm - Authentication is through the NTML protocol.
  • GssApi - Authentication is through the GSSAPI protocol.
  • OAuth20 - Authentication is through the OAuth 2.0 protocol.
Username Text Yes, if Use authentication is selected (Empty) USERNAME="theUser" The username to use to for authentication. This parameter is only available and required if the Use authentication parameter is selected.
NOTE: The email address in the From parameter should belong to the authenticated user.
Password Text Yes, if Use authentication is selected (Empty) PASSWORD="text (encrypted)" The password that corresponds with the Username parameter to use for authentication. This parameter is only available and required if the Use authentication parameter is selected.
NOTE: The email address in the From parameter should belong to the authenticated user.
Certificate Text No (Empty) CERTIFICATE="c:\folder\certname.pfx" Specifies the path and file name of the certificate (.cer or .pfx extension) to use to authenticate. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Passphrase Text No (Empty) CERTIFICATEPASSPHRASE="text (encrypted)" The certificate passphrase to use to authenticate. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Ignore invalid server certificate Yes/No No No IGNOREINVALIDCERTIFICATE="Yes" If selected, invalid or expired SSL server certificates are ignored. If disabled (default) and an invalid server certificate is found, this step throws an error stating that the security certificate on the server is not valid. This parameter is only available if the Use authentication parameter is selected.
If the Protocol parameter is set to WEBDAV (Exchange 2003, 2007), refer to these parameters.
HTTPS/HTTP Yes/No Yes HTTPS USEHTTP="YES" Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Exchange server Text Yes (Empty) SERVER="server.domain.com" Specifies the address of the Exchange server.
Use authentication --- --- Cleared --- If selected, authentication takes place during the transmission. This parameter is cleared by default.
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.
Authentication Type Text (options) Yes, if Use authentication is selected Basic
  • AUTHTYPE="default"
  • AUTHTYPE="form"
 Specifies the type of authentication to use to connect to the Exchange server. This parameter is only available and required if the Use authentication parameter is selected. The available options are:
  • Basic - Processes basic authentication credentials presented in HTTP headers.
  • Default - Authentication is through the stored Windows credentials of the current user. Selecting this option disables the Domain name, Username, and Password parameters.
  • Form - Authentication is forms-based which lets you use an HTML form to obtain credentials from users who are attempting to access the Exchange server.
NOTE: If you are unsure of the value to use in this parameter, contact your network administrator.
Domain name Text Yes, if Use authentication is selected (Empty) DOMAINNAME="my.domain.com" The domain name to use to authenticate. This parameter is only available and required if the Use authentication parameter is selected.
Username Text Yes, if Use authentication is selected (Empty) USERNAME="theUser" A valid user name to use to log on to the mail server and authenticate the mail transaction. This parameter is only available and required if the Use authentication parameter is selected.
NOTE: The email address in From parameter should belong to the authenticated user.
Password Text Yes, if the Use authentication parameter is selected (Empty) PASSWORD="text (encrypted)" A valid password to use to log on to the mail server and authenticate the mail transaction. This parameter is only available and required if the Use authentication parameter is selected.
NOTE: The email address in From parameter should belong to the authenticated user.
If the Protocol parameter is set to EWS (Exchange 2007 & newer, Online), refer to these parameters.
Username Text Yes (Empty) USERNAME="theUser" The username to use to authenticate the connection to the Exchange server.
NOTE: The email address in From parameter should belong to the authenticated user.
Password Text Yes (Empty) PASSWORD="text (encrypted)" The password that corresponds with the Username parameter to use to authenticate Exchange connection.
NOTE: The email address in From parameter should belong to the authenticated user.
Domain name (optional) Text No (Empty) DOMAINNAME="my.domain.com" The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server.
HTTPS/HTTP Yes/No Yes HTTPS USEHTTP="yes" Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Exchange Server Text Yes (Empty) SERVER="https://www.server.com" Specifies the address of the Exchange server. Click Discover to automatically discover the server based on the information entered in the From, User, and Password parameters.
Authenticate as current windows user Yes/No No No AUTHTYPE="default" If selected, authentication to the Exchange server is by way of the current Windows user's credentials, and the Username, Password and Domain name parameters are disabled. This parameter is disabled by default.
Rediscover server at runtime Yes/No No No AUTODISCOVERURL="YES" If selected, the Autodiscover service automatically performs at runtime (disabled by default). The Autodiscover service makes it easier to configure Outlook 2007 or newer, as well as some mobile phones, by using a user's email address and password to automatically configure a user's profile. Setting this parameter to YES disables the Exchange server parameter
If the Protocol parameter is set to EWS Online, refer to these parameters.
Email address Text Yes (Empty) EMAILADDRESS="test@netauto.com" A valid email address to use to authenticate the connection to the Exchange server.
Tenant ID Text Yes (Empty) TENANTID="text (encrypted)" The tenant ID to use for authentication. This parameter is encrypted in Task Builder.
Client ID Text Yes (Empty) CLIENTID="text (encrypted)" The client ID to use for authentication. This parameter is encrypted in Task Builder.
Client secret Text Yes (Empty) CLIENTSECRET="text (encrypted)" The client secret to use for authentication. This parameter is encrypted in Task Builder. Once the Email address, Tenant ID, Client ID, and Client secret parameters are populated, click Verify to perform a test connection to the Exchange Online server.

Connection - Host > Advanced

Property Type Required Default Markup Description
Disable chunking and pipelining for antivirus Yes/No No No DISABLECHUNKING="YES" If selected, chunking and pipelining are disabled (disabled by default). This parameter is only available if the Protocol parameter is set to SMTP.

Chunking refers to the ability to allow inconveniently large messages to be broken into conveniently-sized smaller chunks. Pipelining reduces the time it takes to send multiple messages. Chunking and pipelining can possibly speed up transmissions.

NOTE: Some anti-virus programs may cause email transmission issues when chunking and pipelining is enabled.
TLS cipher(s) Text (options) Yes, if Protocol is set to SMTP and Security is set to Explicit TLS/SSL or Implicit TLS/SSL All
  • TLSCIPHERS="All"
  • TLSCIPHERS="Anonymous"
  • TLSCIPHERS="DH_anon_EXPORT_WITH_DES40_CBC_SHA"
  • TLSCIPHERS="DH_anon_EXPORT_WITH_RC4_40_MD5"
  • TLSCIPHERS="DH_anon_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="DH_anon_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="DH_anon_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="DH_anon_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="DH_anon_WITH_AES_256_CBC_SHA256"
  • TLSCIPHERS="DH_anon_WITH_DES_CBC_SHA"
  • TLSCIPHERS="DH_anon_WITH_RC4_128_MD5"
  • TLSCIPHERS="DHE_DSS_EXPORT_WITH_DES40_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_EXPORT1024_WITH_RC4_56_SHA"
  • TLSCIPHERS="DHE_DSS_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="DHE_DSS_WITH_AES_128_GCM_SHA256"
  • TLSCIPHERS="DHE_DSS_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_WITH_AES_256_CBC_SHA256"
  • TLSCIPHERS="DHE_DSS_WITH_AES_256_GCM_SHA384"
  • TLSCIPHERS="DHE_DSS_WITH_DES_CBC_SHA"
  • TLSCIPHERS="DHE_DSS_WITH_RC4_128_SHA"
  • TLSCIPHERS="DHE_RSA_EXPORT_WITH_DES40_CBC_SHA"
  • TLSCIPHERS="DHE_RSA_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="DHE_RSA_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="DHE_RSA_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="DHE_RSA_WITH_AES_128_GCM_SHA256"
  • TLSCIPHERS="DHE_RSA_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="DHE_RSA_WITH_AES_256_CBC_SHA256"
  • TLSCIPHERS="DHE_RSA_WITH_AES_256_GCM_SHA384"
  • TLSCIPHERS="DHE_RSA_WITH_DES_CBC_SHA"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_128_GCM_SHA256"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_256_CBC_SHA384"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"
  • TLSCIPHERS="ECDHE_ECDSA_WITH_RC4_128_SHA"
  • TLSCIPHERS="ECDHE_RSA_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_128_GCM_SHA256"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_256_CBC_SHA384"
  • TLSCIPHERS="ECDHE_RSA_WITH_AES_256_GCM_SHA384"
  • TLSCIPHERS="ECDHE_RSA_WITH_RC4_128_SHA"
  • TLSCIPHERS="RSA_EXPORT_WITH_DES40_CBC_SHA"
  • TLSCIPHERS="RSA_EXPORT_WITH_RC2_CBC_40_MD5"
  • TLSCIPHERS="RSA_EXPORT_WITH_RC4_40_MD5"
  • TLSCIPHERS="RSA_EXPORT1024_WITH_DES_CBC_SHA"
  • TLSCIPHERS="RSA_EXPORT1024_WITH_RC4_56_SHA"
  • TLSCIPHERS="RSA_WITH_3DES_EDE_CBC_SHA"
  • TLSCIPHERS="RSA_WITH_AES_128_CBC_SHA"
  • TLSCIPHERS="RSA_WITH_AES_128_CBC_SHA256"
  • TLSCIPHERS="RSA_WITH_AES_128_GCM_SHA256"
  • TLSCIPHERS="RSA_WITH_AES_256_CBC_SHA"
  • TLSCIPHERS="RSA_WITH_AES_256_CBC_SHA256"
  • TLSCIPHERS="RSA_WITH_AES_256_GCM_SHA384"
  • TLSCIPHERS="RSA_WITH_DES_CBC_SHA"
  • TLSCIPHERS="RSA_WITH_RC4_128_MD5"
  • TLSCIPHERS="RSA_WITH_RC4_128_SHA"
  • TLSCIPHERS="Secure"
  • TLSCIPHERS="Vulnerable"
  • TLSCIPHERS="Weak"
 Specifies the TLS/SSL cipher to use. This parameter is only available and required if the Protocol parameter is set to SMTP and the Security parameter to Explicit TLS/SSL or Implicit TLS/SSL. The following cipher options are:
  • All - Specifies all ciphers, including the weak ciphers, excluding anonymous ciphers.
  • Anonymous - Specifies anonymous ciphers.
  • DH_anon_EXPORT_WITH_DES40_CBC_SHA - Anonymous exportable 40-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • DH_anon_EXPORT_WITH_RC4_40_MD5 - Anonymous exportable 40-bit RC4 with MD5 hash and message authentication code.
  • DH_anon_WITH_3DES_EDE_CBC_SHA - Anonymous TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • DH_anon_WITH_AES_128_CBC_SHA - Anonymous 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DH_anon_WITH_AES_128_CBC_SHA256 - Anonymous 128-bit AES in CBC mode with SHA256 hash and message authentication code.
  • DH_anon_WITH_AES_256_CBC_SHA - Anonymous 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DH_anon_WITH_AES_256_CBC_SHA256 - Anonymous 256-bit AES in CBC mode with SHA256 hash and message authentication code.
  • DH_anon_WITH_DES_CBC_SHA - Anonymous DES in CBC mode with SHA-1 hash and message authentication code.
  • DH_anon_WITH_RC4_128_MD5 - Anonymous 128-bit RC4 with MD5 hash and message authentication code.
  • DHE_DSS_EXPORT_WITH_DES40_CBC_SHA - Exportable 40-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA - Exportable 56-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_EXPORT1024_WITH_RC4_56_SHA - Exportable 40-bit RC4 with SHA-1 hash and message authentication code.
  • DHE_DSS_WITH_3DES_EDE_CBC_SHA - TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_WITH_AES_128_CBC_SHA - 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_WITH_AES_128_CBC_SHA256 - 128-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • DHE_DSS_WITH_AES_128_GCM_SHA256 - 128-bit AES in GCM mode with SHA-256 hash and authenticated encryption (AEAD).
  • DHE_DSS_WITH_AES_256_CBC_SHA - 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_WITH_AES_256_CBC_SHA256 - 256-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • DHE_DSS_WITH_AES_256_GCM_SHA384 - 256-bit AES in GCM mode with SHA-384 hash and authenticated encryption (AEAD).
  • DHE_DSS_WITH_DES_CBC_SHA - 56-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_DSS_WITH_RC4_128_SHA - 128-bit RC4 with SHA-1 hash and message authentication code.
  • DHE_RSA_EXPORT_WITH_DES40_CBC_SHA - Exportable 40-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_RSA_WITH_3DES_EDE_CBC_SHA - TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_RSA_WITH_AES_128_CBC_SHA - 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_RSA_WITH_AES_128_CBC_SHA256 - 128-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • DHE_RSA_WITH_AES_128_GCM_SHA256 - 128-bit AES in GCM mode with SHA-256 hash and authenticated encryption (AEAD).
  • DHE_RSA_WITH_AES_256_CBC_SHA - 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • DHE_RSA_WITH_AES_256_CBC_SHA256 - 256-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • DHE_RSA_WITH_AES_256_GCM_SHA384 - 256-bit AES in GCM mode with SHA-384 hash and authenticated encryption (AEAD).
  • DHE_RSA_WITH_DES_CBC_SHA - 56-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA - TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_ECDSA_WITH_AES_128_CBC_SHA - 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 - 128-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 - 128-bit AES in GCM mode with SHA-256 hash and authenticated encryption (AEAD).
  • ECDHE_ECDSA_WITH_AES_256_CBC_SHA - 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 - 256-bit AES in CBC mode with SHA-384 hash and message authentication code.
  • ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 - 256-bit AES in GCM mode with SHA-384 hash and authenticated encryption (AEAD).
  • ECDHE_ECDSA_WITH_RC4_128_SHA - 128-bit RC4 with SHA-1 hash and message authentication code.
  • ECDHE_RSA_WITH_3DES_EDE_CBC_SHA - TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_RSA_WITH_AES_128_CBC_SHA - 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_RSA_WITH_AES_128_CBC_SHA256 - 128-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • ECDHE_RSA_WITH_AES_128_GCM_SHA256 - 128-bit AES in GCM mode with SHA-256 hash and authenticated encryption (AEAD).
  • ECDHE_RSA_WITH_AES_256_CBC_SHA - 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • ECDHE_RSA_WITH_AES_256_CBC_SHA384 - 256-bit AES in CBC mode with SHA-384 hash and message authentication code.
  • ECDHE_RSA_WITH_AES_256_GCM_SHA384 - 256-bit AES in GCM mode with SHA-384 hash and authenticated encryption (AEAD).
  • ECDHE_RSA_WITH_RC4_128_SHA - 128-bit RC4 with SHA-1 hash and message authentication code.
  • None - No cipher suite.
  • RSA_EXPORT_WITH_DES40_CBC_SHA - Exportable 40-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_EXPORT_WITH_RC2_CBC_40_MD5 - Exportable 40-bit RC2 in CBC mode with MD5 hash and message authentication code.
  • RSA_EXPORT_WITH_RC4_40_MD5 - Exportable 40-bit RC4 with MD5 hash and message authentication code.
  • RSA_EXPORT1024_WITH_DES_CBC_SHA - Exportable 56-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_EXPORT1024_WITH_RC4_56_SHA - Exportable 56-bit RC4 mode with SHA-1 hash and message authentication code.
  • RSA_WITH_3DES_EDE_CBC_SHA -TripleDES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_WITH_AES_128_CBC_SHA - 128-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_WITH_AES_128_CBC_SHA256 - 256-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • RSA_WITH_AES_128_GCM_SHA256 - 128-bit AES in GCM mode with SHA-256 hash and authenticated encryption (AEAD).
  • RSA_WITH_AES_256_CBC_SHA - 256-bit AES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_WITH_AES_256_CBC_SHA256 - 128-bit AES in CBC mode with SHA-256 hash and message authentication code.
  • RSA_WITH_AES_256_GCM_SHA384- 256-bit AES in GCM mode with SHA-384 hash and authenticated encryption (AEAD).
  • RSA_WITH_DES_CBC_SHA - 56-bit DES in CBC mode with SHA-1 hash and message authentication code.
  • RSA_WITH_RC4_128_MD5 - 128-bit RC4 with MD5 hash and message authentication code.
  • RSA_WITH_RC4_128_SHA - 128-bit RC4 with SHA-1 hash and message authentication code.
  • Secure - Specifies all ciphers that are currently considered secure.
  • Vulnerable - Specifies all ciphers that are currently considered vulnerable.
  • Weak - Specifies all ciphers that are considered weak.
TLS option(s) Text (options) Yes, if Protocol is set to SMTP and Security is set to Explicit TLS/SSL or Implicit TLS/SSL Any
  • TLSVERSIONS="Any"
  • TLSVERSIONS="None"
  • TLSVERSIONS="SSL30"
  • TLSVERSIONS="TLS10"
  • TLSVERSIONS="TLS11"
  • TLSVERSIONS="TLS12"
 Specifies the TLS/SSL versions allowed. This parameter is only available and required if the Protocol parameter is set to SMTP and the Security parameter to Explicit TLS/SSL or Implicit TLS/SSL. The available options are:
  • Any - Use any supported protocol.
  • None - None.

  • SSL30 - SSL 3.0 protocol.

    WARNING: According to RFC 7568, SSL 3.0 is comprehensively broken and must not be used.
  • TLS10 - TLS 1.0 protocol.
  • TLS11 - TLS 1.1 protocol.
  • TLS12 - TLS 1.2 protocol.
Impersonate Yes/No No No IMPERSONATE="YES" If selected, this parameter allows an account on an Exchange server to perform actions by using the permissions that are associated with another account, instead of the permissions that are associated with the caller's account. This parameter is disabled by default. This parameter is only available if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online).
NOTE: With Exchange Impersonation, one account is acting as another account. When an account is impersonated, the system logs the access as if the account that is specified in the header were acting on the system. The calling account must have the appropriate permissions to perform impersonation.
Ignore invalid server certificate Yes/No No No IGNOREINVALIDCERTIFICATE="YES" If selected, invalid or expired SSL server certificates are ignored. If disabled (default) and an invalid server certificate is found, this step throws an error stating that the security certificate on the server is not valid. This parameter is only available if the Protocol parameter is set to EWS (Exchange 2007 & newer, Online).
Proxy type Text (options) No System default
  • PROXYTYPE="none"
  • PROXYTYPE="socks4"
  • PROXYTYPE="socks4a"
  • PROXYTYPE="socks5"
  • PROXYTYPE="http"
 Specifies the proxy type for Automate to use when attempting network communications through a proxy server. The available options are:
  • System default - Uses the default configurations set for Proxy in the Default Properties section of Task Administrator (Options > Default Properties > Proxy).
  • None - Explicitly instructs the action not to use a proxy server regardless of the system default.
  • SOCKS 4 - Instructs the action to go through a SOCKS 4-compliant server.
  • SOCKS 4a - Instructs the action to go through a SOCKS 4a -compliant server.
  • SOCKS 5 - Instructs the action to go through a SOCKS 5-compliant server.
  • HTTP - Instructs the action to go through an HTTP-compliant server.
NOTE:
  • To create the most portable tasks, it is best to select System default and specify proxy settings globally in the Default Properties section. By proceeding in this manner, tasks created in one environment that may have a proxy server will be portable to others that do not, and vice-versa.
  • If you are unsure of the value to use in this parameter, contact your network administrator.
Proxy server Text Yes, if Proxy type is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP (Empty)
  • PROXYSERVER="proxy.host.com"
  • PROXYSERVER="xxx.xxx.xxx.xxx"
 The hostname (server.domain.com) or IP address of the proxy server. This parameter is only available and required if the Proxy type parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy port Number Yes, if Proxy type set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP 1028 PROXYPORT="3000" The proxy port number to use to connect to the proxy server. Most proxy servers operate on port 1028 ( default), however, a proxy server can operate on other ports. This parameter is only available and required if the Proxy type parameter is set to SOCKS 4, SOCKS 4A, SOCKS 5, or HTTP.
Proxy username (optional) Text No (Empty) PROXYUSERNAME="username" The username to use to authenticate when connecting through the proxy server. This parameter is only available if Proxy type is set to SOCKS 5 or HTTP.
Proxy password (optional) Text No (Empty) PROXYPASSWORD="text (encrypted)" The password corresponding with the Proxy username parameter to use to authenticate when connecting through the proxy server. This parameter is encrypted in Task Builder. This parameter is only available if Proxy type is set to SOCKS 5 or HTTP.

Message

Property Type Required Default Markup Description
From Text Yes (Empty) FROM="me@mycompany.com" Specifies the email address to use to send the message. This parameter accepts the following formats:
  • FROM="me@mycompany.com"
  • FROM="MyCompanyWebmaster<webmaster@netauto.com>"(Exchange protocol only)
NOTE: This email address should belong to the authenticated user.
To Text Yes (Empty) TO="you@netauto.com" Specifies the email addresses to receive the message. Multiple email addresses are specified by separating each with a semi-colon (;). This parameter accepts the following formats:
  • TO="you@netauto.com"
  • TO="bob@netauto.com;amy@netauto.com"
  • TO="NetworkAutomationWebmaster<webmaster@netauto.com>"(Exchange protocol only)
Subject Text No (Empty) SUBJECT="Weekly Report" The subject of the message.
Body Text No (Empty) BODY="This is the body" The body of the message.
NOTE: If the Is HTML parameter is selected, use properly formatted HTML as the body of the message. If disabled (default), use plain text as the body.
Is HTML Yes/No No No HTML="YES" If selected, specifies the body of the message is formatted HTML and displayed by the recipient's mail client as such, if supported. In addition, the following mail header data is inserted: Content-Type: multipart; boundary="xxxxx". If disabled (default), the message is formatted in plain text.
Use file content(s) as body Text No Cleared BODYFILE="c:\foldername\body.txt" If selected, the body of the message is obtained from the specified text file and the Body parameter is disabled. Enter the path and file name of the desired file manually, or click the folder button to navigate to the desired file. This parameter is disabled by default.
NOTE: This parameter only accepts contents of a single file and does not support contents from multiple files.

Attachments

Property Type Required Default Markup Description
Attachment Text No (Empty)
  • ATTACH="c:\folder\file.zip
  • ATTACH="c:\file1.zip;c:\file2.zip"
 Specifies the files to attach to the email message. Files are MIME-encoded automatically.

In AML mode, multiple file attachments are added manually and must be separated by semi-colons (;).

In visual mode, attachments are added by clicking the Click here to add new row text, and then clicking the folder icon. Browse to the appropriate file to attach, and then click Open. Repeat these steps for any additional files.

NOTE: If a specified file name contains semi-colons, enclose the path in brackets (for example, (c:\temp\image;001.png)).

Options

Property Type Required Default Markup Description
Cc Text No (Empty) CC="admin@mycompany.com" Specifies the email addresses to send a carbon copy of the message to. Multiple recipients must be separated by semi-colons (;). This parameter accepts the following formats:
  • webmaster@mycompany.com
  • My Company Webmaster <webmaster@mycompany.com>
  • webmaster@mycompany.com;sales@mycompany.com
Bcc Text No (Empty) BCC="sales@mycompany.com" Specifies the email addresses to send a blind carbon copy of the message to. The Bcc parameter hides email addresses entered in it from all recipients. Multiple recipients must be separated by semi-colons (;). This parameter accepts the following formats:
  • webmaster@mycompany.com
  • My Company Webmaster <webmaster@mycompany.com>
  • webmaster@mycompany.com;sales@mycompany.com
Reply to Text No (Empty) REPLYTO="me@mycompany.com Specifies the email address to use to send a reply to the original message.
XMailer Text No AutoMate XMAILER="AM8" Identifies the software that created the email message. This parameter is set to AutoMate by default.
Priority Text (options) Yes Normal
  • PRIORITY="low"
  • PRIORITY="high"
 The level of importance to assign to the message to send. The recipient's email client may indicate the importance you assigned to a message. For example, messages marked with highest importance may appear in bold text or marked in red for the Subject or From email address fields in the Inbox, while less important messages may appear grayed out or prioritized further down the list. The available options are:
  • Low - The message is set to low importance.
  • Normal (default) - No importance level is assigned. The recipient does not receive an alert.
  • High- The message is set to high importance.
Sensitivity Text (options) Yes Normal
  • SENSITIVITY="personal"
  • SENSITIVITY="private"
  • SENSITIVITY="confidential"
 The level of sensitivity to assign to the message to send. Specific text is displayed in the InfoBar of the message to indicate the level of sensitivity, based on the setting selected. The available options are:
  • Normal (default) - No sensitivity level is assigned to the message, so no text is displayed in the InfoBar.
  • Personal - "Please treat this as Personal" is displayed in the InfoBar.
  • Private - "Please treat this as Private" is displayed in the InfoBar.
  • Confidential - "Please treat this as Confidential" is displayed in the InfoBar.
IMPORTANT: These settings are only an advisory. Recipients can take any desired action on the message, such as forwarding a confidential message to another person.
Request delivery report Yes/No No No REQUESTDELIVERYREPORT="YES" If selected, specifies a delivery receipt is received upon delivery of the email message to the recipient's mailbox. This option is disabled by default.
IMPORTANT: A delivery receipt may not be received if they are not supported by the recipient's email program.
Read receipt Yes/No No No READRECEIPT="YES" If selected, specifies a read receipt is sent when the email message is opened. This option is disabled by default.
IMPORTANT: In Microsoft Office Outlook, the recipient has the option to decline to send read receipts. Additionally, read receipts are not sent if they are not supported by recipient's email program.
Custom header(s) Text No (Empty) CUSTOMHEADERS="Description;Daily Report" Specifies one or more custom headers to send. Sending custom headers is a practical way to exchange information using a standardized approach.

To specify a custom header, click the Click here to add new row text, and then enter the desired header name and value in the corresponding Name and Value text boxes.
Create and populate dataset Text No (Empty) RESULTDATASET="myDataset" The name of dataset to create and populate with the results of the email sent. More details regarding the fields that this dataset creates can be found below under Datasets.

Description

Error Causes

On Error

Additional Notes

Datasets

A dataset is a multiple column, multiple row container object. This activity creates and populates a dataset containing a specific set of fields in addition to the standard dataset fields. The table below describes these fields (assuming the dataset name assigned was theDataset).

Name Type Return Value
theDataset.Headers Text The header information of the email sent.
theDataset.ReplyAddress Text The Reply email address of the email sent.
theDataset.FromAddress Text The From email address of the email sent
theDataset.ToAddress Text The To email address of the email sent.
theDataset.CCAddress Text The CC email addresses of the email sent.
theDataset.Subject Text The Subject of the email sent.
theDataset.Body Text The body content of the email sent.
theDataset.Attachments Text The file names of any attachments included with the email sent.
theDataset.Date Number The send date of the email sent.

Example

NOTE:
  • The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
  • Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.

Description

This sample task sends an email message with an attachment.

Copy 
<AMEMAIL ACTIVITY="send" PROTOCOLTYPE="ews" AUTODISCOVERURL="YES" IGNOREINVALIDCERTIFICATE="YES" USERNAME="me" PASSWORD="AM5v/1z5E9M4M53cdHFhBTZDdP4wUHccSezBhj1vPBEVbU=aME" DOMAINNAME="my.domain.com" FROM="me@mycompany.com" TO="you@yourcompany.com" SUBJECT="report" BODY="This is the body of the email" ATTACH="C:\Temp\Folder10\report.txt" />