Skip to main content Skip to complementary content

Creating your first map

Create a mapping of one type of document to another by importing an existing document or starting from scratch.

About this task

Follow 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 .

Procedure

  1. Import or create the structure definitions by right-clicking in the Repository navigator and choosing New > Structure. Possible sources of structures are:
    • AVRO schema - import an Apache AVRO file. For more details, refer to Mapping Avro.

    • COBOL - import a COBOL copybook. For more details, refer to COBOL Considerations.

    • CSV Sample - import a CSV sample document. For more details, refer to Mapping CSV.

    • Database (deprecated) - import table definitions directly from a database. For more details, see Database.

    • EDI - import EDI Guideline XML (gXML) files. For more details, see EDI Representation.

    • Java (deprecated) - import Java classes or Jar files. For more details, see Java Representation.

    • JSON Sample Document - import JSON definitions based on a JSON sample document. For more information, see Mapping JSON.

    • OpenAPI Specifications - import an OpenAPI Specifications file. For more information, see OpenAPI Specifications.

    • REST API Definitions - import a REST API description. For more information, see REST API Definitions.

    • SAP IDocs or SAP IDocs from Json - import IDocs documents from an SAP system. For more information, see Mapping SAP IDocs.

    • XML Schema (XSD) or XML DTD (deprecated) or XML Sample or WSDL (Web Services Definition Language) - Import any of these to process XML documents. For more details, see XML Representation.

    • Manual - You can manually create a structure by adding elements in the structure editor. Typically used for flat (delimited/positional) data. For more information, see Flat Representation.

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

  2. Right-click New > Map in the Repository navigator to set up a map. This executes the map creation wizard.
  3. Drag the structure corresponding to the input document to the input panel of the map's editor.
  4. Drag the structure corresponding to the output document to the output panel of the map's editor.
  5. 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.
    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.
  6. Select Test > Test Run specifying a test document to test your transformation. The screen displays the output.
    Information noteTip: You can also try the extensive Examples.

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!

Leave your feedback here