Creating your first map - 6.3

Talend Data Mapper User Guide

Talend Big Data Platform
Talend Data Fabric
Talend Data Management Platform
Talend Data Services Platform
Talend MDM Platform
Talend Real-Time Big Data Platform
Design and Development
Talend Studio

Here are the basic steps to map one type of document to another assuming you are starting from scratch. You can also go through the cheat sheets (tutorials) by going to Help > Cheat Sheets and selecting Data Mapper.

  1. Import or Create the structure definitions by right-clicking in the Repository navigator and choosing New > Structure. Possible sources of structures are:

    1. XML Schema (XSD)/DTD/XML Sample/WSDL - Import any of these to process XML documents. See XML Representation for more details.

    2. CSV Sample - Import a CSV sample document. See Flat Representation for more details.

    3. Manual - You can manually create a structure by adding elements in the structure editor. Typically used for flat (delimited/positional) data. See Flat Representation for more details.

    4. COBOL - Import a COBOL copybook. See COBOL Considerations for more details.

    5. Database - Import table definitions directly from a database. See Database for more details.

    6. Java - Import Java classes or Jar files. See Java Representation for more details.

    7. EDI - Import EDI Guideline XML (gXML) files. See EDI Representation for more details.

    8. Projects - Import a previously exported project. Use the Import menu item for this.

  2. Set up the map by right-clicking New > Map in the Repository navigator which executes the map creation wizard. Once the map is created, drag the structure corresponding to the input document to the input panel of the map's editor, and drag the structure corresponding to the output document to the output panel of the map's editor.

  3. Map elements from the input panel to the output panel by dragging an input element to an output element. This causes the input element value to be copied to the output element value.

    Note that after you have dropped the input element to the output element, the output element is selected and the Output Value panel contains Concat followed by the name of the input element. This indicates the output element is created by copying the specified input element.

  4. Test your transformation by choosing Test > Test Run specifying a test document. The output is displayed on the screen

There are also extensive Examples.