Converting the class of the incoming data pages
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.
- In a data flow, click the Plus icon on a shape, and select Convert.
- Double-click the Convert shape to configure it.
-
Select a conversion mode.
- Top-level - Converts the class of the top level data pages to another class in your application. When you select this option, the Convert shape outputs a data record for every incoming data record.
- Embedded - Extracts and converts a property that is embedded in the top-level page list 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.
- For the Top-level mode, select the Auto-copy properties with identical names option to overwrite properties in the target class with properties that have the same name in the source class.
- Click Add mapping to map properties that do not have the same name between the source class and the target class.
- Click Submit.
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.