Email

Description

Defines the default mail server to use when Automate Desktop sends an email On Task Error, or when the Connection parameter is set to System for the Email - Send message activity.

To access the Email Default Properties, from the Task Administrator, navigate to Options > Default Properties > Email.

Related Topics

Mail server

Property Description
SMTP/Microsoft Exchange/None The mail server to use for outgoing email. The available options are:
  • SMTP - Uses Simple Mail Transfer Protocol (SMTP) as the mail server. Refer to the SMTP parameters for this option.
  • Microsoft Exchange - Uses Exchange as the mail server. Refer to the Microsoft Exchange parameters for this option.
  • None - Disables the Email Default Properties.

SMTP parameters

The following parameters are available when the mail server is set to SMTP:

Property Description
Server The default SMTP mail server to use (for example, mail.yourdomain.com).
Port The port number to use for the default SMTP mail server. If the Security parameter is set to No Security or Explicit TLS/SSL the default port number is 25, and if it is set to Implicit TLS/SS, the default port number is 465. The port number can also vary for special network configurations.
Authentication type Specifies the type of authentication to use. The available options are:
  • None (default) - Select this option if authentication is not required.
  • Auto - This option automatically determines the authentication type to use.
  • Plain - Authentication is through the Plain protocol.  
  • Digest-MD5 - Authentication is through the Digest-MD5 protocol.
  • CRAM-MD5 - Authentication is through the CRAM-MD5 protocol.
  • Login - Authentication is through the Login protocol.
  • NTLM - Authentication is through the NTML protocol.
  • GSS-API - Authentication is through the GSS-API protocol.
Username The username to use to sign in to the SMTP mail server and authenticate the mail transaction. This parameter becomes available and is required when the Authentication type parameter is set to Auto, Plain, Digest-MD5, CRAM-MD5, Login, NTLM, or GSS-API.
Password The password to use to sign in to the SMTP mail server and authenticate the mail transaction. This parameter becomes available and is required when the Authentication type parameter is set to Auto, Plain, Digest-MD5, CRAM-MD5, Login, NTLM, or GSS-API.
Security Specifies the SMTP security settings. The available options are:
  • No security (default) - Select this option encryption is not required.
  • Explicit TLS/SSL - Allows incoming connections to use the StartTLS command to initiate a secure TLS connection.
  • Implicit TLS/SSL - Allows a secondary dedicated port for secure SSL connections to be opened. The implicit SSL port will also be affected by all the normal port bindings and limits.
Certificate Specifies the path and file name of the certificate (.pfx) to use to authenticate. Select the icon to browse to the SSL certificate file. This parameter is only available if the Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.
Passphrase 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 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 Security parameter is set to Explicit TLS/SSL or Implicit TLS/SSL.

Microsoft Exchange parameters

The following properties are available when the mail server is set to Microsoft Exchange:

Property Description
Protocol Specifies the Exchange server protocol to use. The available options are:
  • EWS (Exchange 2007 & newer) - Uses the Exchange Web Services (EWS) protocol. Compatible with Microsoft Exchange Server 2007 and newer versions.
  • WEBDAV (Exchange 2003, 2007) - Uses the Web Distributed Authoring and Provisioning (WEBDAV) protocol. Compatible with Microsoft Exchange Server 2003 and Exchange Server 2007.
  • EWS Online - Uses the EWS protocol to access Microsoft Exchange Online by way of Modern Authentication.
If Protocol is set to EWS (Exchange 2007 & newer), refer to these parameters.
Email address or username A valid email address or username to use to authenticate with the Exchange server.
Password The password that corresponds with the Email address or username parameter to authenticate with the Exchange server. This parameter is optional if your email address or user name does not require a password to sign in to the Exchange server.
Domain (optional) The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server.
HTTPS/HTTP Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Server Specifies the address of the Exchange server. Select Discover to automatically discover the server based on the information entered in the Email address or username and Password parameters.
Ignore invalid server certificate 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.
If Protocol is set to WEBDAV (Exchange 2003, 2007), refer to these parameters.
Email address or username A valid email address or username to use to authenticate with the Exchange server.
Authentication type The Exchange server authentication type. This parameter is active only if the Protocol parameter is set to WEBDAV (Exchange 2003, 2007).  The available options are:
  • None
  • Basic
  • Form
Password The password that corresponds with the Email address or username parameter to authenticate with the Exchange server.
Domain The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server.
HTTPS/HTTP Indicates whether to use HTTP (normal HTTP) or HTTPS (secure HTTP) as the Exchange server protocol type.
Server Specifies the address of the Exchange server. Select Discover to automatically discover the server based on the information entered in the Email address or username and Password parameters.
If Protocol is set to EWS Online, refer to these parameters.
Email address A valid email address to use to authenticate the connection to the Exchange server.
Tenant ID The Directory (tenant) ID to use for authentication. This parameter is encrypted in Task Builder.
Client ID The Application (client) ID to use for authentication. This parameter is encrypted in Task Builder.
Client secret The client secret Value to use for authentication. This parameter is encrypted in Task Builder.