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
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.
Right-click
New > Map in the Repository
navigator to set up a map. This executes the map creation
wizard.
Drag the structure corresponding to the input document to the input panel of
the map's editor.
Drag the structure corresponding to the output document to the output panel of
the map's editor.
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.
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!
