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.
1.0.0.5 Changed handling of TrustedCertificateSubject so that valid certificates are always trusted in addition to those with the specified subject
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.
Only one Connection per Site should specify a value for TrustedCertificateSubject. If multiple Nodes with Connections that use conflicting TrustedCertificateSubject values run concurrently, the last one to load will take precedence which can result in the error The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel. (System.Net.WebException).
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.