5.2 Modifying the JSON/XML Payload

After you install the default JSON package, you can transform the payload generated in the <driver-operation-data> to a format supported by your RESTful service. You can modify the JSON/XML payloads that are received in the Subscriber and Publisher channels through conversion policies. The conversion policies modify the request and response documents to a compatible format that is easily comprehended by both Identity Manager and the connected application..

The conversion can be done using any of the following three methods:

  • Use the default XDS to JSON conversion policy to transform the payload generated in the <driver-operation-data> to a format supported by your RESTful service.

  • Create your own XDS to JSON conversion policy, and ensure to keep the payload in <driver-operation-data> so that the driver transfers the same to the connected application. The steps to disable an existing policy and add a new policy is shown below:

    1. Select the REST Driver Object in designer.

    2. Select Outline tab.

    3. Select Output from the transformation diagram. This shows you all the output transformation policies.

    4. Navigate to the Policy Set tab and select the XDS-JSON policy (for example, <NETQRESTJSON-otp-XDStoJSON>) you want to disable.

    5. Click the icon to disable the policy as shown in the following image.

    6. Click , in the Policy Set section to add the new policy.

    7. Name the policy accordingly.

    8. Double click the newly created policy, and navigate to XML Source tab in the right pane.

    9. Paste the new xml content for this policy in the display area.

    10. Save all your changes and deploy these policies to Identity Manager.

  • Driver shim automatically performs the conversion without any conversion policies.