Skip to main content Skip to complementary content

Refactoring Structures

When you need to change the underlying structure of a Talend Data Mapper map, you can refactor it easily through the user interface. The refactoring option is useful if you wish to upgrade your Map from using an older version of a structure to a newer version and want to keep the specified mappings or other elements.

Moving elements within the map

  • On the input element, right-click the elements that you want to move and select Move expression references. The dialog box displays an option for you to specify the new location of your expression or elements.
  • On the output element, right-click the previously specified mappings in the structure and select Copy. Then right-click Paste Expressions on the element where you wish to move the mappings to.

Editing Structures used in a Map

When an input or output structure changes as a result of editing the Structure or re-importing some external metadata (XML Schema, JSON, Swagger, and so forth), maps using these Structures continue to show all elements as they initially were. If elements were removed or moved elsewhere, they appear with a special deleted icon. The expressions associated with such deleted nodes will still be available although displayed in red in the Map editor.

You can copy and paste expressions associated with deleted elements to new elements.

Once you have finished refactoring your map, right-click on the Structure and select Delete invalid Map elements to remove all the deleted elements.

Replacing Input or Output Structure in a Map

If you need to completely replace a Structure with another in a Map, you can do so in either ways:

  • Right-click on the Structure root in the Map editor and use the Select Input Structure or the Select Output Structure dropdown options.
  • Right-click on the Map in the Project Explorer. Select Properties > Mapping and select the different Structures for Input and Output.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!