Description

Used to send an e-mail message, plain text or HTML formatted, with or without attachments, using the Internet Standard SMTP Protocol. Internet. NOTE: AOL and MSN do not support SMTP. Most other ISPs, however, do support SMTP. Frequently system administrators will choose to use this action to perform system notifications or conveniently package data retrieved from any other source such as databases or Web sites.

Declaration

<AMSMTPMAIL SUBJECT="text" HTML="yes/no" ATTACH="text" TO="text" CC="text" BCC="text" SERVER="text" PORT="number" FROM="text" REPLYTO="text" PROXYTYPE="text [options]" PROXYSERVER="text" PROXYPORT="number" PROXYUSERNAME="text" PROXYPASSWORD="text">text</AMSMTPMAIL>

Example

<AMSMTPMAIL SUBJECT="This is a test of the email action of Automated Workflow 5" TO="Webmaster@networkautomation.com" SERVER="mail.server.com" FROM="me@networkautomation.com">Hello this is the body of my message

</AMSMTPMAIL>

General Tab Parameters

To: Specifies the recipient(s) of the message. Multiple recipients must be separated by semi-colons (;). The recipient parameter can be in any of the following formats:

• Webmaster@networkautomation.com

• Webmaster <Webmaster@networkautomation.com>

• Webmaster@networkautomation.com;sales@networkautomation.com

Text, Required
MARKUP: TO="Webmaster@networkautomation.com"

Subject: Specifies the subject of the message.

Text, Optional - Default (blank)
MARKUP: SUBJECT="This is a test message from Automated Workflow 5"

Body: Specifies the body of the message. If the "Is HTML" [HTML] parameter is set to YES, this section should be properly formatted HTML, otherwise this parameter should contain a plain text version of the message.

Text, Optional - Default (blank)
MARKUP: >"This is a test message from Automated Workflow 5"</SMTPMAIL>

Is HTML: Specifies that the body of the message is formatted HTML and should be displayed by the recipients mail client as such (if supported). Causes the following mail header to be inserted: Content-Type: multipart; boundary="xxxxx"

YES/NO, Optional - Default NO
MARKUP: HTML="YES"

Use file contents as body: Specifies that the body of the message should be obtained from the specified text file. When set to YES causes the Body of the message to be ignored.

Text, Optional - Default (blank)
MARKUP: BODYFILE="c:\foldername\body.txt"

Advanced Tab Parameters

From: Specifies the address information about whom the mail should be from. The FROM parameter can be in any of the following formats:

• Webmaster@networkautomation.com

• Webmaster <Webmaster@networkautomation.com>

Text, Optional - Default (blank but usually required by most servers)
MARKUP: <SENDER SERVER="mail.server.com" FROM="me@networkautomation.com" REPLYTO="meinstead@networkautomation.com

Reply to: Specifies the address information about whom the mail should be from. The Reply to parameter can be in any of the following formats:

• Webmaster@networkautomation.com

• Webmaster <Webmaster@networkautomation.com>

Text, Optional - Default (blank)
MARKUP: <SENDER SERVER="mail.server.com" FROM="me@networkautomation.com" REPLYTO="meinstead@networkautomation.com

CC: Specifies addresses that the message should be sent "carbon-copies" to. Multiple recipients must be separated by semi-colons (;). The CC parameter can be in any of the following formats:

• Webmaster@networkautomation.com

• Webmaster <Webmaster@networkautomation.com>

• Webmaster@networkautomation.com;sales@networkautomation.com

Text, Optional - Default (blank)
MARKUP: CC="Webmaster@networkautomation.com"

BCC: Specifies addresses that the message should be sent "blind-carbon-copies" to. Use of the "blind-carbon-copies" hides the addresses from the target users. Multiple recipients must be separated by semi-colons (;). The BCC parameter can be in any of the following formats:

• Webmaster@networkautomation.com

• Webmaster <Webmaster@networkautomation.com>

• Webmaster@networkautomation.com;sales@networkautomation.com

Text, Optional - Default (blank)
MARKUP: BCC="Webmaster@networkautomation.com"

Attachment Tab Parameters

Attach: Specifies file(s) to attach to the e-mail message. Files will be MIME encoded automatically. In Markup mode, multiple file attachments must be separated by semi-colons (;), in visual mode simply add the files to the list.

Text, Optional - Default (blank)
MARKUP: ATTACH="c:\foldername\file1toattach.zip;c:\foldername\optionalfile2toattach.zip;"

To add one or more attachments

1. Select the attachment using the open icon or insert an expression. (Click the Expression Builder icon to build and insert an expression.)

2. Click Add. The attachment appears in the Current attachments box.

To edit or remove an attachment

• Click the attachment in the Current attachments box, then click Edit or Remove.

Server Tab Parameters

Default server settings or Custom server settings: Specifies the SMTP server that should be used to send the message.

Text, Optional - Default (blank, uses default server for the Automated Workflow installation)
MARKUP: SERVER="mail.server.com"

For Custom server settings, specify the IP address/domain, Port, username, and password to connect to the SMTP server.

Proxy Tab Parameters

Proxy type: Specifies proxy protocol that should be used.  If you are unsure of the value to use in this parameter, contact your network administrator.

• System Default (default, recommended)

• 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

Text [options], Optional - Default (none)
MARKUP: PROXYTYPE="Socks5"

Proxy host: Specifies the hostname (server.domain.com) or IP address (xxx.xxx.xxx.xxx) of the proxy server.

Text, Optional - Default (blank)
MARKUP: PROXYSERVER="proxy.host.com"

Proxy port: Specifies the port that should be used to connect to the proxy server. Most proxy servers operate on port 1028 (the default) however the proxy server can be customized to operate on other ports.

Number, Optional - Default 1028
MARKUP: PROXYPORT="3000"

User ID (Proxy): Specifies the username that should be used to authenticate when connecting through the proxy server. This option is only valid when Socks 5 is specified in the Proxy type as it is the only version that supports authentication

Text, Optional - Default (none)
MARKUP: PROXYUSERNAME="username"

Password (Proxy): Specifies the password that should be used to authenticate when connecting through the proxy server. When the step is created using the Designer it is written to the Workflow encrypted. This option is only valid when Socks 5 is specified in the Proxy type as it is the only version that supports authentication.

Text, Optional - Default (none)
MARKUP: PROXYPASSWORD="encrypted"

See Also

POP3 E-mail, HTTP Download, HTTP Post, Open Web Page