Skip to main content
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.

Data Transforms

Data transforms

The purpose of a data transform is to manipulate data in an application. Data transforms copy or manipulate data into the form you require. Data transforms can be used to convert data from one type to another, iterate over page lists, or page groups and copy entire pages at a time. 

Consider the checkout process of a purchasing application. The customer provides a shipping address and is prompted to provide a billing address. The billing address and shipping address are likely the same. It is more efficient to use a data transform to copy the shipping address to the billing address rather than have the customer reenter the shipping address. Further, into the checkout process, the customer must provide their full name for credit card processing. Use a data transform to copy the first name and last name properties from the customer account into a single full-name property.

Example of how data transforms are used in a checkout example

You can use data transforms to convert data from one type to another type. For example, to complete the checkout process in the purchasing application, the customer must provide their card number in the payment gateway. Use a data transform to copy and convert the stored string format credit card information into the card number property.

Note: To convert the string into a number, open the expression builder, click the Configure icon, and use the out-of-the-box (OOTB) functions available in Pega Platform™. In the credit card number example, you can use the toInt() function.

You can call a data transform from a flow. In a flow, click the connector to open the Connector properties window. In the Set properties section, select Apply data transform.

Apply data transform in a flow rule

Consider another example. An auto repair parent case has a child case that handles providing the necessary repairs. The child case contains a menu of possible items and services that can be provided, including unit costs. The items and services that are provided are copied to the parent case for invoicing. Use a data transform to iterate over the list of possible items and services and only copy those entries with a quantity greater than zero.

An auto repair parent case and service child case uses a data transform
Tip: When accessing information in different cases (for example, in a parent-child case relationship), consider referencing data from the parent case rather than copying information from the parent case to the child case. Reference data to avoid synchronization issues if data changes on the parent case.

Check your knowledge with the following interaction.

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice