The HTTP Post Request activity sends a HTTP request to the specified location, the HTTP endpoint, and receives a HTTP response back from that location.
The following figure shows the HTTP Post Request activity sending a HTTP request to the specified location, the HTTP endpoint, and receiving a HTTP response back:
Field or Check Box | Description |
---|---|
URL (Path after Hostname) | Specifies the resource path that the Post Request activity posts the request to, for example: /mypath. The string you specify in this field must exclude the string: http://, the hostname, and the port number of the Integration Appliance. The full URL is automatically constructed from the hostname of the Integration Appliance, the port number specified in the HTTP endpoint, and the path specified in this field. For example, if the full URL that the Post Request activity posts the request to is http://myAR:myPort/myPath, in this field you only need to specify the string: /myPath. The specified path must be unique for the Post Request activities that are deployed at the same time on the same Integration Appliance using the same port. |
Where Request Message is Of Type | Specifies the expected message type of the HTTP request - either Text or Binary. |
Where Reply Message is Of Type | Specifies the message type of the HTTP reply - either Text or Binary. |
Stop Processing the Orchestration Job or Continue Processing and Return the HTTP Error code |
Specifies the run time behavior of the activity
if an error response is returned from the HTTP Server:
|
Use Compression/Decompression | Specifies if compression/decompression is turned on or off at the activity level. By default, the Use Compression/Decompression check box is clear and compression/decompression is disabled for this activity. Select the Use Compression/Decompression check box to enable compression/decompression for this activity. For more information, see Compression/Decompression with the HTTP Post Request activity. |
Fields | Description |
---|---|
Retry | |
1) Wait __ seconds between each retry. | The number of seconds that the Integration Appliance waits before trying to establish a connection to the HTTP Server. |
2) Try to connect __ times before failing. | Specifies the retry count - the maximum number
of times the Integration Appliance attempts to establish a connection
to the HTTP Server before issuing an error and stopping the processing
of the current orchestration job. If you deploy an orchestration that contains an HTTP Post Request activity and the Integration Appliance cannot connect to the specified HTTP Server, the Integration Appliance logs the connections errors as Warnings in the system and orchestration logs until the retry count value is reached. When the retry count is reached, the Integration Appliance logs an error in the system and orchestration logs and the stops processing the current orchestration job. For example, you set the retry count to 3. The first, second, and third connection errors appear in the system log as warnings. The Integration Appliance logs the fourth connection error as an error and stops processing the current orchestration job. |
Activity Timeout | |
3) Time out after ___ seconds when the Endpoint does not respond to a request. | Specifies the amount of time in seconds before a timeout occurs between the activity making a request on an Endpoint and the time it takes the Endpoint to respond. For the HTTP Post Request activity, the activity timeout is the amount of time that the Integration Appliance waits for a response from the HTTP Server after sending a HTTP request, before the Integration Appliance issues a timeout error. An activity timeout is different from a connection timeout because an activity timeout occurs after the connection to the endpoint has been established. A connection timeout specifies the amount of time in seconds before a timeout occurs between the Integration Appliance attempting to establish a connection to the endpoint and the time it takes for the endpoint to respond to the connection request. You set the connection timeout in HTTP Endpoint tab. For more information about connection timeouts, see Creating or editing an HTTP endpoint. |
Nodes of the httpheaders Input Parameter | Description |
---|---|
httpheaders/uri | Specifies the resource path, for example: /myPath. |
httpheaders/method | Specifies the type of HTTP request. |
httpheaders/otherHeaders/headerItem | Specifies an element that contains a set of HTTP header parameters as name/value pairs. Multiple HTTP header parameters can be specified in the HTTP request, so this is a recurring node. |
ttpheaders/otherHeaders/headerItem/name | Specifies the name of the HTTP header parameter. |
httpheaders/otherHeaders/headerItem/value | Specifies the value of the HTTP header parameter. |
Nodes of the httpConnParameter Input Parameter | Description | Overrides what settings in the HTTP endpoint? |
---|---|---|
timeout | ||
host | Specifies the hostname or IP address of the remote HTTP server. | The host node of the httpConnParameter input parameter overrides the Host Name field of the HTTP endpoint. |
port | Specifies the port number of the remote HTTP server. | The port node of the httpConnParameter input parameter overrides the Port field of the HTTP endpoint. |
isSecure | Set this boolean equal to true to enable HTTPS - secure HTTP over SSL. Set this boolean equal to false to disable security. | The isSecure node of the httpConnParameter input parameter overrides the Security option in the HTTP endpoint. |
username | Specifies the user name for the account used to connect to the HTTP server. | The username node of the httpConnParameter input parameter overrides the User Name field in the HTTP endpoint. |
password | Specifies the password for the account used to connect to the HTTP Server. | The password node of the httpConnParameter input parameter overrides the Password field in the HTTP endpoint. |
Output Parameter | Description |
---|---|
httpheaders | Specifies the header of the HTTP response. |
body | Specifies the body of the HTTP response message. |
responsecode | Specifies the HTTP Response Code that is returned from the HTTP Server during run time. |
responsemessage | Specifies the message associated with the HTTP Response Code. |
Nodes of the httpheaders Output Parameter | Description |
---|---|
httpheaders/uri | Specifies the resource path, for example: /myPath. |
httpheaders/method | Specifies the type of HTTP response. |
httpheaders/otherHeaders/headerItem | Specifies a set of name/value pairs that contain the HTTP parameters of the HTTP response. Multiple HTTP parameters can be specified in the HTTP response, so headerItem is a recurring node. |
httpheaders/otherHeaders/headerItem/name | Specifies the name of the HTTP parameter. |
httpheaders/otherHeaders/headerItem/value | Specifies the value of the HTTP parameter. |