Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

JSON data transforms

Updated on April 6, 2022

A data transform defines how to convert data that is in one format and class (the source) into data of another format and class (the target). Use JSON data transforms when you need to integrate disparate data, for example, responses from external data sources, with the application data model.

The following wizards automatically generate JSON data transforms when you create a REST integration in Pega Platform: You can reference JSON data transforms in data pages in your request or response data transforms. JSON data transforms are an efficient approach to serializing and deserializing JSON, which improves the performance of your REST integrations. You can also easily update JSON data transforms because they support mapping and translation from the external data model to the clipboard data model.

Mapping JSON elements to multiple clipboard properties

If you map a single JSON element to multiple clipboard properties in a JSON data transform, the system sets the value from the JSON element on the last property. This behavior applies to properties that are included within the same hierarchy level.

For example, you set an Append and Map to action in your JSON data transform and configure two properties, .CardName and .CardName2. You set both properties to the "name" JSON element. If you run the JSON data transform in deserialization mode, only .CardName2 is set to "name" because it is the latter property in the set action.

Example of mapping the same JSON element to multiple properties
A list of properties mapped to the same JSON element in a JSON data transform.

Conversely, you configure two properties called .CardName, and set one property to the “name” JSON element and the other property to the “name2” JSON element. If you run the JSON data transform in serialization mode, the system sets the value of .CardName to “name2” because “name2” is the latter field in the set action.

Example of mapping different JSON elements to the same property
A list of JSON elements mapped to the same property in a JSON data transform.

For more information about JSON data transforms, see the following documentation:

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us