Table of Contents


  1. Preface
  2. Introduction to REST V2 Connector
  3. REST V2 connections
  4. REST V2 operations
  5. Mappings and mapping tasks with REST V2 Connector
  6. Appendix A: Supported swagger objects

REST V2 Connector

REST V2 Connector

Midstream transformation mapping example

Midstream transformation

You are a human resources administrator and you want to retrieve details of an employee from Apache CouchDB.
To retrieve employee details from CouchDB and to write the employee details to a flat file, perform the following tasks:
  1. Create a REST V2 connection to read data from CouchDB.
    The following image shows the configured CouchDB connection:
  2. Create a business service to associate the REST V2 connection and an operation.
    The following image shows the configured business service:
  3. Create a REST V2 mapping.
  4. Add a Web Services transformation. Specify a name and description in the general properties.
  5. On the
    Web Service
    tab, select the business service and the operation that you configured. Also, specify paging parameters.
    The following image shows the configured web service:
  6. On the
    Request Mapping
    tab, map the incoming fields from the source to the respective fields in CouchDB.
  7. On the
    Response Mapping
    tab, select the employee details fields that you want to write to the target file on the
    Response Structure
  8. On the
    tab, specify the cache size details.
    The fields that you selected from the
    Response Structure
    of the Web Service transformation appear as incoming fields for the target object.
  9. If required, map the incoming fields to the flat file fields.
  10. Click
    Mapping Task
    , and select the mapping for the task.
  11. When you save and run the
    task, the Secure Agent retrieves the employee record for the employee that you map on the Request Mapping tab from CouchDB and writes the data to the corresponding flat files.

Updated December 14, 2020