HTTP Post/Put Action

Declaration

<AMHTTPPOST URL="text" TYPE="text [options]" STRING="text" FILE="text" PORT="number" TIMEOUT="number" USERNAME="text" PASSWORD="text" PROXYTYPE="text [options]" PROXYSERVER="text" PROXYPORT="text" PROXYUSERNAME="text" PROXYPASSWORD="text">

See Also

HTTP Download, Send Keystrokes, Open Web Page

Description

Posts or uploads form data using the HTTP protocol to the specified URL.

Practical Usage

Useful when data must be posted or uploaded via HTTP protocol without using an external browser.

Parameters

General Tab

URL

Text, Required
MARKUP: URL="http://www.networkautomation.com/index.htm"

Specifies a URL (uniform resource locator) to which the data should be posted.

Type

Text [options], Required
MARKUP: TYPE="string"

Specifies whether data should be posted from a specific string (text) or from data in a file. The available options are:

String

Text, yes/no default=yes
MARKUP: STRING="name=steve&city=Los%20Angeles&phone=555-5555"

Specifies a string of data to post. Valid strings are determined by the sever.

File

Text, Optional
MARKUP: FILE="c:\filename\file.txt"

Specifies the path and filename of a file containing the data that should be posted to the URL specified.

Use Put command

Yes/No, Optional - Default NO
MARKUP: ACTION="put"

 

Specifies whether a "put" command should be used to upload the specified data (as opposed to a "Post" command).

Block Cookies

Yes/No, Optional - Default NO
MARKUP: BLOCKCOOKIES="yes"

 

Specifies whether cookies should be blocked during transmission. HTTP cookies are used for authenticating, session tracking (state maintenance), and maintaining specific information about users. If "yes", AutoMate will not store cookies.

 

Connection Tab

Username

Text, Optional
MARKUP: USERNAME="johndoe"

Causes an attempt authenticate with the server first. Specifies the user name to be used during the authentication.

Password

Text, Optional
MARKUP: PASSWORD="mypassword"

Causes an attempt authenticate with the server first. Specifies the password to be used during the authentication.  If created in visual mode, this value is automatically encrypted.

Timeout (in seconds)

Number, Optional default=10
MARKUP: TIMEOUT="50"

Specifies the maximum time in seconds that the step should wait for a response from the HTTP server before giving up. It may be useful to increase this value when posting extremely large amounts of data or if waiting for a long transaction to complete.

 

Advanced Tab

Populate variable with result

Text, Optional
MARKUP: RESULTVARIABLE="varname"

Specifies the name of the variable that should be populated with the results of the transmission.

Content type

Text, Optional
MARKUP: CONTENTTYPE="text"

Specifies the data content type to be posted.

User Agent

Text, Required default=AutoMate
MARKUP: USERAGENT="text"

Sometimes it's necessary for a web site to understand how it is being viewed, so most user agents identify themselves by sending a User Agent String to the web site. The User-Agent request-header field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations (the default User agent entered is AutoMate).

Certificate file

Text, Required default=AutoMate
MARKUP: CERTIFICATE="Certificate_Filename"

Specifies the path and filename of the certificate file used to validate connection. AutoMate supports the following certificate file types:

Passphrase

Text, Optional - Default (none)
MARKUP: PASSPHRASE="passphrase"

Specifies the passphrase used to authenticate connection. A passphrase is a password that comprises a whole phrase.

Ignore invalid server certificates

Yes/No, Optional - Default NO
MARKUP: IGNOREINVALIDCERTIFICATE="yes"

If enabled, specifies that this action will ignore invalid certificates when connecting to a server using SSL.

Use compatibility mode

Yes/No, Optional - Default NO
MARKUP: COMPATIBILITY="yes"

 

If enabled, functionality reverts to AutoMate's legacy HTTP engine (used in AutoMate 6 and older versions). This option is available mainly for AutoMate 6 or older users.

Proxy Tab

Proxy Type

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

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

The available options are:

Proxy Port

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

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

Proxy Host

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

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

User Name (Proxy)

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

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.

Password (Proxy)

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

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

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMHTTPPOST URL="http://www.networkautomation.com/automate/" STRING="name=steve&amp;company=dustin">

<AMHTTPPOST URL="http://www.networkautomation.com/automate/" WHATTOPOST="file" FILE="c:\postdata.txt">