Description
This steps submits an http post request to a specified url.
The result is the response (if any) to the post request.
Options
| Options |
Description |
|---|---|
| Step name | Name of the step; This name has to be unique in a single transformation |
| URL |
A static destination for the post request. |
| Accept URL from field? |
Enable this alternative in order to dynamically specify the post URL from a field. |
| URL field name |
Specify which field contains the URL post address (assuming that "Accept URL from field?" is checked.) |
| Encoding |
Specify the encoding of the post request |
| Request entity field | The name of the field that will contain the post request. When enabled, the "Post a file" option will retrieve a file named in the Request entity field, and post the contents of that file. |
| Post a file | Enable this in conjunction with "Request entity field" in order to send contents of a file as a post request. |
| Result fieldname | Specify the fieldname to contain the result retrieved from the post request (optional). |
| HTTP status code fieldname |
Specify the fieldname to contain the HTTP status code (optional). [since version 3.2.3] |
| Body (Header) Parameters | Specify multiple post parameters of the form Parameter=Name. Specific fields will fill the name part. Since version 3.2.3 you can specifiy if a specific parameter is put in the body (default=N) or header (Y). |
| Query Parameters | Specify multiple query parameters of the form Value=Name. Specific fields will fill the name part. |
Comments
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.