Executing Maps

Once your Data Map is complete you can use it in one of three places:

• Process Designer
• Workflow Designer
• Service Routing Tables

Process Designer

In Neuron ESB Explorer, navigate to Processes and either create a new process or open an existing process. Find the Data Mapper step in the toolbox and drag it onto the design surface. You can create a new Data Map by either double-clicking the Data Mapper process step or right-click and select Open Data Mapper…:

If you are creating a new map, you will need to import a source and target document and create at least one mapping between the two. After that, when you save the Data Map you will be prompted to provide a name for the new Data Map:

If you already have a Data Map, you can configure the Data Mapper process step to use by selecting a Data Mapper Name in the process step’s property grid:

Depending on the output type of your Data Map, different properties will be displayed for the Data Mapper process step:

XML Output:

• Include Xml Declaration – This determines if the XML Declaration is added to the XML output.

JSON Output:

• Null Value Handling – This property has three options:
  • None – All logic regarding null values will be handled by transformations in the Data Map
  • Null – The output will also be Null
  • EmptyString – The output value will be an empty string

Workflow Designer

In Neuron ESB Explorer, navigate to Processes and either create a new workflow or open an existing workflow. Find the Data Mapper activity in the toolbox and drag it onto the design surface.

Note – Unlike the Process designer, you cannot open and edit a Data Map from the Workflow designer. You can only configure the Data Mapper activity to execute a Data Map.

Set the properties for the Data Mapper activity:

• DisplayName – The display name for this activity instance.
• Message – The defined ESB Message argument or variable that will be the input (source) message of the Data Map.
• Result – The defined ESB Message argument or variable that will be the output (target) message of the Data Map.
• DataMapperName – The name of the Data Map to use from the Neuron ESB Repository.
• IncludeXmlDeclaration – For XML output only. This determines if the XML Declaration is added to the XML output.
• TreatNullHandling – For JSON output only. This property has three options:
  • None – All logic regarding null values will be handled by transformations in the Data Map
  • Null – The output will also be Null
  • EmptyString – The output value will be an empty string

Service Routing Tables

When creating Service Routing Tables, you can configure service routes to execute a Data Map on the request message, response message, or both:

The Data Map(s) will need to be created in the Neuron ESB Repository before they can be selected for use in a Service Route Table.