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

Source fields

Source fields

You can configure the source fields that you want to use in the data flow. You can add and remove source fields, configure how the fields are displayed, edit field metadata, and restore original fields from the source object.
Configure source fields on the
Fields
tab of the
Properties
panel.
You can configure source fields in the following ways:
Add the source file name to each row.
If you are using a file list as the source, and you want to identify the source for each row, add the source file name to the field list. You can pass this information to the target table.
To add the source file name to each row, enable the
Add Currently Processed Filename Field
option. When you enable this option,
Data Integration
adds the CurrentlyProcessedFileName field to the Fields table. The
Add Currently Processed Filename Field
option is visible for file sources.
When you enable or disable this option,
Data Integration
prompts you to synchronize fields with the source object. You can synchronize all fields, synchronize new fields only, or skip the synchronization.
Retain existing fields at runtime.
If field metadata changes after a mapping is saved,
Data Integration
uses the updated field metadata when you run the mapping. Typically, this is the desired behavior. However, if the mapping uses a native flat file connection and you want to retain the metadata used at design time, enable the
Retain existing fields at runtime
option. When you enable this option,
Data Integration
mapping tasks will use the field metadata that was used when you created the mapping.
Add and remove fields.
You can add fields to a mapping source. Add a field to retrieve a field from the source object that is not displayed in the list. To add a field, click
Add Field
, and then enter the field name, type, precision, and scale.
You can also remove fields that you do not want to use in the mapping. To remove fields, select the fields that you want to remove, and then click
Delete
.
Change the sort order.
You can display source fields in native order, ascending order, or descending order. To change the sort order, click
Sort
, and select the appropriate sort order.
Use technical field names or labels.
You can display field names by label or technical field name.
To change the display option for field names, select
Options
Use Technical Field Names
or
Options
Use Labels
.
Edit field metadata.
You can edit the metadata for a field. You might edit metadata to change information that is incorrectly inferred. When you edit metadata, you can change the name, native type, native precision, and native scale, if applicable for the data type. For some source types, you can also change the transformation data type in the
Type
column.
To edit the name or metadata for one or more fields, click
Options
Edit Metadata
. When you edit metadata, you can also display native names by label or technical field name. To change the display option for native names, select
Options
Show Technical Field Names
or
Options
Show Labels
.
When you change the metadata for a field, avoid making changes that can cause errors when you run the task. For example, you can usually increase the native precision or native scale of a field without causing errors. But if you reduce the precision of a field, you might cause the truncation of data.
Restore original fields from the source object.
To restore the original fields from the source object, enable the
Synchronize
option. When you synchronize fields,
Data Integration
restores deleted source fields and adds fields that are new to the source.
Data Integration
removes any added fields that do not have corresponding fields in the source object.
Data Integration
updates the metadata for existing source fields based on whether you synchronize all fields or synchronize new fields only. When you synchronize all fields,
Data Integration
replaces any field metadata that you edited with the field metadata from the source object. When you synchronize new fields only,
Data Integration
retains the metadata for any existing source field.
Data Integration
does not revert changes that you made to the
Name
field.