Skip to main content

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

Converting the class of the incoming data pages

Updated on July 5, 2022

You change the class of the incoming data pages to another class when you need to make the data available elsewhere.

For example, you want to store data in a data set that is in a different class than your data flow and contains different names of properties than the source data set. You might also want to propagate only a part of the incoming data to a branched destination, like strategy results (without customer data) to the Interaction History data set.
  1. In a data flow, click the Plus icon on a shape, and select Convert.
  2. Double-click the Convert shape to configure it.
  3. In the Convert configurations window, select a conversion mode:
    • To convert the class of the top-level data pages to another class in your application, select Top-level, and then select the class.

      When you select this option, the Convert shape outputs a data record for every incoming data record.

    • To extract and convert a property that is embedded in the top-level page list property, select Embedded, and then select the property.

      The type of the property can be page or page list. The page that is the source for the unpacked property can be preserved and propagated to another destination in the data flow through a different branch. When you select this option, the Convert shape outputs as many data records as the number of properties in the page or page list.

  4. Optional: If you selected the top-level mode, to overwrite properties in the target class with properties that have the same name in the source class, in the Field mapping section, select the Auto-copy properties with identical names option.
    Important: When you select this option, the Convert shape copies all the properties from the source class, including the transient properties such as pzMarkers. This might increase the space needed to store these values or create performance issues later.
    Sample Convert shape configuration using top-level mode
    On the Convert configurations window, the top-level and auto-copy properties options are selected. A single mapping is added.
  5. Click Add mapping to map properties that do not have the same name between the source class and the target class.
  6. Click Submit.
For example: When you select the Embedded mode to convert a .Customer data record with three appended pages that are called .Subscription_1,.Subscription_2, and .Subscription_3, the Convert shape outputs three data records.

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