Versions Compared

Old Version 1

changes.mady.by.user Tijmen Daatselaar

Saved on

compared with

New Version Current

changes.mady.by.user Tijmen Daatselaar

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The data mapping simulator is integrated in a tool that helps you debugging and providing insight into how a data mapping is executed by actually executing the data mapping editor. It can be used to debug your data mapping, and provides insight into how the runtime handles data mappings, without having to refer to . This makes development and maintenance faster since there is no need to test the data mapping though manually running and clicking through an application and referring to the runtime logging (although this remains possible).  The simulator is fully integrated in the data mapping editor.

In fact, the simulator uses the runtime to:

...

Now it is time to run the mapping using the run button in the top of the editor. Four steps will come available after running the test:

#DescriptionExample
1

Link instances: shows which instances are mapped and which instances will be created. 

Image Modified

Note that since person #1 does not meet the precondition, no instance is created nor mapped. 

2Instance management: shows which new instances are actually created.

Image Modified

3Link values: shows which values will be used in the next step

Image Modified

4Set values: sets the values.

Image Modified

5Clear values: shows which values are cleared.

Image Modified

Note that the

nam of Client5 is

name of Client #5 has been cleared because the value in the source module was unknown

Expand
titleTroubleshooting when the mapping does not run
  1. Make your model valid
    Since the data mapping simulator uses the runtime to run the data mapping, the model needs to be valid. If a validation error exists, an extra tab will appear next to the steps and problems tabs. 
  2. Configure the datamapping-simulator bootstrap profile
    To be able to use the model mapping simulation functionality in the runtime, the datamapping-simulator profile has to be added to the bootstrap.properties file. 
  3. Establish a connection between Blueriq Encore and the runtime
    Make sure nginx has been configured properly there is a Runtime running properly on the same domain as Encore.

3. View the result of the data mapping

The result of the data mapping is the output: the profile after mapping. After instances have been created during the execution of a mapping, the instances will be shown in the panel on the right. Instances can be selected here to view the values of attributes and relations of this instance. It is also possible to compare this output profile with an expected profile. This would be the unit test of a data mapping (rule). Read more about unit testing a data mapping here.