Table of Contents

Search

  1. Preface
  2. Transformations
  3. Source transformation
  4. Target transformation
  5. Aggregator transformation
  6. Cleanse transformation
  7. Data Masking transformation
  8. Deduplicate transformation
  9. Expression transformation
  10. Filter transformation
  11. Hierarchy Builder transformation
  12. Hierarchy Parser transformation
  13. Hierarchy Processor transformation
  14. Input transformation
  15. Java transformation
  16. Java transformation API reference
  17. Joiner transformation
  18. Labeler transformation
  19. Lookup transformation
  20. Mapplet transformation
  21. Normalizer transformation
  22. Output transformation
  23. Parse transformation
  24. Python transformation
  25. Rank transformation
  26. Router transformation
  27. Rule Specification transformation
  28. Sequence Generator transformation
  29. Sorter transformation
  30. SQL transformation
  31. Structure Parser transformation
  32. Transaction Control transformation
  33. Union transformation
  34. Velocity transformation
  35. Verifier transformation
  36. Web Services transformation

Transformations

Transformations

Data source configuration in hierarchical output example

Data source configuration in hierarchical output example

When you add a nested array to the output and choose to preserve the incoming field, the records that get created vary based on how you configure the data source for the output group.
For example, you want to extract the description information from a nested array of maintenance records in a JSON file. The description information is in an array of strings. You want the output data to also be in an array of strings.
The following sample data shows an incoming record:
[ { "vehicle": [ { "make": "Toyota", "model": "Corolla", "insurance": { "company": "Allstate", "policy_num": "AS12876" }, "maintenance": [ { "date": "01/01/2020", "description": ["oil filter1", "oil filter2"] }, { "date": "01/08/2020", "description": ["tire rotation1", "tire rotation2"] } ] }, { "make": "Toyota", "model": "RAV4", "insurance": { "company": "Allstate", "policy_num": "AS2033" }, "maintenance": [ { "date": "01/02/2020", "description": ["air filter replacement1", "air filter replacement2"] }, { "date": "01/08/2020", "description": ["battery replacement1", "battery replacement2"] } ] } ] } ]
In the Hierarchy Processor transformation, you add the description array to the output group and choose
Preserve Incoming Field
.
The following image shows the incoming and output fields:
The image shows the Hierarchy Processor tab of the Hierarchy Processor transformation. The Incoming Fields panel contains one input group with the following field: vehicle (array). The vehicle array contains the following fields: make (string), model (string) insurance (struct), and maintenance (array). The insurance struct contains the following fields: company (string) and policy_num (string). The maintenance array contains the following fields: date (string) and description (array of strings). The Output Fields panel contains the following field: description (array of strings).
When
Data Integration
creates the output array, it sets the data source for the description array to
Input.vehicle.vehicle.maintenance.maintenance.desc.elem
, indicating that the information for the output array comes from the elements in the desc array in the Input group. By default,
Data Integration
sets the data source for the Output group to
Input
.
The data source configuration for the Output group determines how
Data Integration
creates the output records.
To collate all descriptions into one output record, keep the data source for the Output group as
Input
. This produces the following output:
{"description":["battery replacement2","battery replacement1","air filter replacement2","air filter replacement1","tire rotation2","tire rotation1","oil filter2","oil filter1"]}
To create one output record for each occurrence of vehicle in the incoming data, set the data source to
Input.vehicle.vehicle
. In this case, the output data contains one record for each vehicle:
{"description":["tire rotation2","tire rotation1","oil filter2","oil filter1"]} {"description":["battery replacement2","battery replacement1","air filter replacement2","air filter replacement1"]}
To create one output record for each occurrence of maintenance in the incoming data, set the data source to
Input.vehicle.vehicle.maintenance.maintenance
. In this case, the output contains one record for each maintenance record:
{"description":["oil filter2","oil filter1"]} {"description":["tire rotation2","tire rotation1"]} {"description":["air filter replacement2","air filter replacement1"]} {"description":["battery replacement2","battery replacement1"]}