HTTP Post

Description

This step uses an HTTP POST command to submit form data via a URL.

Note: The data of the input fields can be escaped by the Calculator step and the function "Mask XML content from string A" or "Escape HTML content"

General Tab

The General tab defines which RSS/Atom URLs you want to use, and optionally which fields contain the URLs.

Option

Description

Step name

The name of this step in the transformation workspace.

URL

The Web service URL to submit to.

Accept URL from field?

If checked, you must specify which field to retrieve the URL from.

URL field name

If the previous option is checked, this is where you specify the URL field.

Encoding

The encoding standard for the files being accessed.

Request entity field

The name of the field that will contain the POST request. When enabled, the Post a file option will retrieve the file named in this field, and post the contents of that file.

Post a file

If a file is defined in the Request entity field, its contents will be posted if this option is checked. Currently "Request entity field" must be filled in order for "Post a file" to work. Selecting "Post a file" and specifying a field under "Body parameters" without selecting a value for "Request entity field" (the place for the file name) will fail silently.

Connection timeout

Defines the timeout (defaults to 10000) in Milliseconds when a connection attempt will error out.

Socket timeout

Defines the timeout (defaults to 10000) in Milliseconds when a socket will error out.

Connection close wait time

Define the wait time after the connection is closed in Milliseconds, the default -1 means the default wait time from the operating system (often 2 minutes).
Background information: Each row opens a connection and keeps it in a so called TIME-WAIT state for a specific time. A lot (may be thousands) of connections in a TIME-WAIT state introduce significant memory overhead. This option can reduce this memory overhead by reducing the time to keep a closed connection in a TIME-WAIT state.

Result fieldname

The field that you want to post the result output to.

HTTP status code fieldname

The field that you want to post the status code output to.

Response time (milliseconds) fieldname

The field that you want to post the response time, in milliseconds, to.

HTTP login

If this form requires authentication, this field should contain the username.

HTTP password

If this form requires authentication, this field should contain the password that corresponds with the username.

Proxy host

Hostname or IP address of the proxy server, if you use one.

Proxy port

Port number of the proxy server, if you use one.

Fields tab: Body (Header) Parameters

The Fields tab defines parameters for the HTTP request header and body. If you've filled in the URL and other necessary details in the General tab, you can use the Get values buttons to pre-populate the fields here. Body parameters are used in POST and PUT operations.

Option

Description

#

The order that this parameter will be passed to the Web application.

Name

The name of the field that contains the value to map to the parameter.

Parameter

The parameter to map the value of Name to.

Put in Header?

If set to Y, the parameter will be put into the request header.

Fields tab: Query Parameters

The Fields tab defines parameters for the HTTP request header and body. If you've filled in the URL and other necessary details in the General tab, you can use the Get values buttons to pre-populate the fields here. Query parameters are specified in the URL and can be used in any HTTP method.

Option

Description

#

The order that this parameter will be passed to the Web application.

Name

The name of the field that contains the value to map to the parameter.

Value

The value to map to the parameter.