Email - Delete single message

Declaration

<AMEMAIL ACTIVITY="remove_message" SESSION="text" PROTOCOLTYPE="text (options)" EMAILADDRESS="text" USEHTTP="YES/NO" SERVER="text" PORT="number" AUTODISCOVERURL="YES/NO" IMPERSONATE="YES/NO" AUTHTYPE="text (options)" USERNAME="text" PASSWORD="text (encrypted)" DOMAINNAME="text" TENANTID="text (encrypted)" CLIENTID="text (encrypted)" CLIENTSECRET="text (encrypted)" CURRENTFOLDER="text" TIMEOUT="number" SECURITY="text (options)" CERTIFICATE="text" CERTIFICATEPASSPHRASE="text (encrypted)" IGNOREINVALIDCERTIFICATE="YES/NO" TLSCIPHERS="text (options)" TLSVERSIONS="text (options)" PROXYTYPE="text (options)" PROXYSERVER="text" PROXYPORT="number" PROXYUSERNAME="text" PROXYPASSWORD="text (encrypted)" MESSAGEID="text" MESSAGE="text"/>

Related Topics

Description

Deletes one or more messages from the specified server. This activity contains a filtering function that allows removal of specific messages based on the filter specified.

Practical Usage

Commonly used to remove a specific message by its message ID or message sequence number.

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:
  • Host (default) - 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 POP3
  • PROTOCOLTYPE="imap"
  • PROTOCOLTYPE="webdav"
  • PROTOCOLTYPE="ews"
  • PROTOCOLTYPE="ewsonline"
 Specifies the protocol to use to connect to the email server. The available options are:
  • POP3 (default) - Uses the Post Office Protocol version 3 (POP3).
  • IMAP - Uses the Internet Message Access Protocol (IMAP).
  • 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 POP3 or IMAP, refer to these parameters.
Server Text Yes (Empty) SERVER="mail.server.com Specifies the email server address to use with the connection.
Port Number Yes 25 PORT="3333" The port to use to connect to the email server. The default port value varies for each protocol, but this parameter can be customized to connect to another port, if required. The default port numbers are:
  • POP3 - 110
  • IMAP - 143
Security Text (options) Yes No security
  • SECURITY="explicit"
  • SECURITY="implicit"
 The type of security to use with the connection to the email server. 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.
Authentication Type Text (options) Yes Auto
  • AUTHTYPE="Plain"
  • AUTHTYPE="DigestMD5"
  • AUTHTYPE="CramMD5"
  • AUTHTYPE="Login"
  • AUTHTYPE="ClearText"
  • AUTHTYPE="Ntlm"
  • AUTHTYPE="External"
  • AUTHTYPE="GssApi"
  • AUTHTYPE="OAuth20"
 Specifies the authentication protocol to use. 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.
  • ClearText - Authentication is through the ClearText protocol.
  • Ntlm - Authentication is through the NTML protocol.
  • External - Authentication is through the use of an external third-party authentication source.
  • GssApi - Authentication is through the GSSAPI protocol.
  • OAuth20 - Authentication is through the OAuth 2.0 protocol.
Username Text Yes (Empty) USERNAME="theuser" The username to use to for authentication.
Password Text Yes (Empty) PASSWORD="text (encrypted)" The password that corresponds with the Username parameter to use for authentication.
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 to Explicit TLS/SSL or Implicit TLS/SSL.
If the Protocol parameter is set to WEBDAV (Exchange 2003, 2007), 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.
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.
Authentication type Text (options) Yes Basic
  • AUTHTYPE="default"
  • AUTHTYPE="form"
 Specifies the type of authentication to use to connect to the Exchange server. 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 option to use for this parameter, contact your network administrator
Domain name Text Yes (Empty)
  • DOMAINNAME="server.domain.com"
  • DOMAINNAME="xxx.xxx.xxx.xxx"
 The domain name (for example, domain.exchangeServer.com) or IP address to use to connect to the Exchange server. This parameter is only available if the Authentication type parameter is set to Basic or Form.
Username Text Yes (Empty) USERNAME="theUser" A valid username to use to authenticate the connection to the Exchange server. This value may or may not be identical to the value set in the Email address field.
Password Text Yes (Empty) PASSWORD="text (encrypted)" A valid password, corresponding to the Username parameter, to use to authenticate Exchange connection. This parameter is encrypted in Task Builder.
If the Protocol parameter is set to EWS (Exchange 2007 & newer, 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.
Username Text Yes (Empty) USERNAME="theUser" The username to use to authenticate the connection to the Exchange server.
Password Text Yes (Empty) PASSWORD="text (encrypted)" The password that corresponds with the Username parameter to use to authenticate Exchange connection. This parameter is encrypted in Task Builder.
Domain name (optional) Text No (Empty)
  • DOMAINNAME="server.domain.com"
  • DOMAINNAME="xxx.xxx.xxx.xxx"
 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="server.domain.com" Specifies the address of the Exchange server. Click Discover to automatically discover the server based on the credentials entered for the Email address, Username, and Password parameters.
Authenticate as current windows user Yes/No No Disabled 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 cleared 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
Current folder Text Yes Calendar CURRENTFOLDER="Contact" The Exchange folder of where to perform this activity. This parameter is disabled if the Protocol parameter is set to POP3.
Timeout (seconds) Number Yes 100 TIMEOUT="120" The total amount of time in seconds that this activity is allowed to execute before a time out error occurs.
TLS cipher(s) Text (options) Yes, if Protocol is set to SMTP, POP3, or IMAP 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 POP3 or IMAP 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, POP3, or IMAP 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 POP3 or IMAP 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 the 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 recommended 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.

Email

Property Type Required Default Markup Description
Message ID Text No (Empty) MESSAGEID="123456789a" If enabled, specifies the message ID of the email message to delete. If this option is selected, the Message sequence number parameter is ignored.
Message sequence number Number No (Empty) MESSAGE="12" If enabled, specifies the message sequence number of the email message to delete. If this option is enabled, the Message ID parameter is ignored.

Description

Error Causes

On Error

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 deletes a message from an IMAP email server.

Copy 
<AMEMAIL ACTIVITY="remove_message" PROTOCOLTYPE="imap" SERVER="mail.server.com" PORT="143" USERNAME="user" PASSWORD="AM5ryAGeidEWSzG6q5EzOG9HDedLrdlmmakB5IfirCq4cI=aME" TLSCIPHERS="All" TLSVERSIONS="Any" MESSAGE="12" />