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

Add single occurring children

Add single occurring children

When you add incoming struct and array fields to the output, you can choose to add single occurring children. This option adds all single occurring children under the field to the output group, including the single occurring child fields that are nested under a struct. You can select this option when the output is relational.
When you select this option, the incoming field must have child objects.
If the field you select contains an array, the array and its children are not added because an array can contain multiple elements.

Example

You want to extract customer information from the Customer array. Each output record should contain information about one customer.
Add the Customer array to the output group and choose
Add Single Occurring Children
.
The following image shows the incoming and output fields:
The list of incoming fields on the left includes a top-level struct: Customers. Below that struct is an array: Customer. The Customer array contains five string fields and a struct: FullAddress. The struct FullAddress contains three string fields. The output group on the right contains the eight string fields.
All single occurring children under Customer, including the children under the struct FullAddress, map to the output group.
If you choose
Add Single Occurring Children
on the Customers struct, an error message displays because there are no single occurring children under that top-level struct.