Operation Request Bodies

When you create a request body for an Operation, the following Content Type options are available. Selecting one of these options automatically sets the Content-Type header field on the Operation's REST API calls.

Note: You can override this automatically selected Content-Type by specifying a different value manually in the Headers screen.

None

Use this option if you do not want a request body.

Text

Use this option if you want a plain text request body. This option supports Operation Variables.

JSON

Use this option if you want a JSON request body. This option supports Operation Variables.

XML

Use this option if you want an XML request body. This option supports Operation Variables.

URL Encoded

Use this option if you want a URL encoded request body consisting of key/value pairs. This option supports Operation Variables in the Value field.

You can view the encoded string(s) in the logs in the Test screen.

Form Data

Note: This option is available only if you have Connector Wizard 2.0.0.0 or later installed.

Use this option if you want to send a POST request with a multi-part/form-data body. If you select this option, you can specify one or more parts for the request body.

For each entry in the table, you can specify:

  • Name: The name of the entry.

  • Type (File or Text): The type of the entry.

  • Value: In this column, you can either enter text (if Type is set to Text) or a File Operation Variable (if Type is set to File).

  • Content Type: Lets you choose from a list of common Content-Type options. You can also manually enter one if it is not listed. If you do not specify an option, the Content-Type header field is set to text/plain for Text items and application/octet-stream for File entries.

Note: The Form Data option is only for POST calls. If you set up a Form Data request body for a non-POST call, you will not be able to save the Operation.

Binary

This option lets you use a binary file as the request body.

To use this option, first create an Operation Variable of type File.

Next, select the Operation Variable in the File Parameter field. When the user submits the Operation's generated Process Definition, they will be able to specify a file in the Submit Wizard or within a Chain Definition.