Web Form Post

Executes an http Web Form Post, including the optional submission of a File. Use this Connector to post form data to a web URL.

Revision History

1.0.0.1 Initial public version.
1.0.0.2 Added BaseUrl to the Connection.

Properties

Connection

Type: Connection Input

BaseUrl
Type: String
Use this to save a BaseUrl for the connection, which can, of course, be different for each of your Flowgear environments, Dev, Production, etc. When implemented, then the Url on the Node properties must be specified as a path which is relative to this BaseUrl.

Username
Type: String
The username provided for authentication. Authentication is based on 'Basic Auth' and the node will include the username and password as Basic Authorization to the Request Header.

Password
Type: String
The password provided for authentication.

ReturnHttpFailureResponses
Type: Boolean
When True, the node will consume any web request errors and return a success state (and follow execution) with a Status Code property output. The Status Code property can then be used to validate and check the response. All other failures (non web request related) will return an error state.

SessionKey
Type: String
An identifier that links multiple Web Request Nodes on the same workflow by sharing the same Cookie Jar.

TrustedCertificateSubject
Type: String
When supplied, forces a certificate to be trusted if part of its subject matches the text supplied in this property. For example, providing the text www.example.com will allow the site www.domain.com to be trusted if it serves a certificate containing the subject www.example.com. Without this setting, the error Could not establish trust relationship for the SSL/TLS secure channel will be thrown if there is a mismatch between a certificate and the domain being accessed.

DecompressionType
Type: String
Enums: None, Deflate, GZip
The decompression type to be applied on the response returned by the server.

CertificateBase64
Type: String
The Base64 encoded string of the certificate supplied by the destination server.

Base64Password
Type: String
The password to validate the Base64 encoded certificate.

Url

Type: String Input
The URL to which the form is to be posted. As of v1.0.0.2, the Connection has a BaseUrl, which, if used, has the effect that this Url property must be specified as a path which is relative to the BaseUrl in the Connection.

Headers

Type: Multiline Text Input
An optional location for custom HTTP headers, passed in the form: {header}:{value}

Accept: text/xml

Cookies

Type: Multiline Text Input
An optional location for custom HTTP Cookies to be included, passed in the form: {CookieName}={CookieValue}

myCookie=myCookieValuemyOtherCookie=myOtherCookieValue

Form Data

Type: Multiline Text Input
The data fields and value to be posted, passed in the form: {fieldName}={fieldValue}

field1=field 1 Valuefiedl2=field 2 Value

File

Type: File Input
The File content of the file to be posted with the form.

FileName

Type: String Input
The name of the file to be posted with the form. Mandatory when File has a value.

UserAgent

Type: String Input
The value that will be sent for the HTTP User-Agent Header. Use this header to emulate a specific browser.

ReturnBodyAs

Type: List Input
Indicates how the response should be processed to the ResponseBody Property

Text - Indicates that the response should be presented as a string
Binary - Indicates that the response should be converted to a byte array (byte)

StatusCode

Type: String Input
The HTTP Status code that was returned by the server.

ResponseHeaders

Type: Multiline Text Output
Contains all headers that were returned by the server.

ResponseBody

Type: Multiline Text Output
The Response body that was returned by the server.

Remarks

Use this Connector to post a web form to a web URL.

Where multiple steps are required for the integration, share the session by selecting the same Connection on each Web Request Node and ensuring that a SessionKey has been captured into the Connection.