Defining Input and Output Mappings

When you are invoking a REST service operation, you must map the appropriate input/output parameters provided by the REST service operation to the appropriate parameters and/or data fields in the process.

On the Properties view for the relevant task or event, the Input to Service and Output from Service tabs provide a Mapper tool that allows you to easily perform the required mappings.

Data mappings are defined as follows:
  • on the call request (the Input To Service tab), from process fields/parameters to path/query/header/payload parameters exposed by the selected Method.
  • on the call response (the Output From Service tab), from the payload or header parameters exposed by the selected Method to process fields/parameters.

The request / response payload (optional) will be JSON (or 'Unprocessed Text' type). The path and query parameters are used to map into variable parts of the request URL from process data values. The header parameters allow mapping process data to/from request/response header.

Some services will not need a payload, but may still need mappings for headers, path and query parameters.