You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
What is it?
The data mapping simulator is integrated in 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 the runtime logging (although this remains possible).
In fact, the simulator uses the runtime to:
- Run a data mapping using the specified profiles of the source and target module before mapping.
- Show which steps the runtime performed and in which order these steps are performed.
- Show the result of the mapping: the profile of the output after the mapping.
1. Specify the profiles before mapping
Presume we want to map a multiple instances of Person (source module) to multiple instances of Client (target module) using a direct mapping rule with the following configuration (click to enlarge):
We can use the simulator to test whether this mapping correctly maps profiles given the precondition, the match strategy, and the property mappings.
To do this, we have to specify the profile in the source and target module before mapping. We start by adding instances to the source module.
We add 3 instances of person to the source module:
- person #1 who does not meet the precondition,
- person #2 who does meet the precondition and does not have a matching target,
- and person #3 who does meet the precondition and does have a matching target.
We add 1 instance of client to the target module, of which Client.SocialNumber matches Person.BSN.
2. Gain insight into the execution of a data mapping through the "Steps" section
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:
# | Description | Example |
---|---|---|
1 | Link instances: shows which instances are mapped and which instances will be created. | Note that since person #1 does not meet the precondition, no instance is created nor mapped. |
2 | Instance management: shows which new instances are actually created. | |
3 | Link values: shows which values will be used in the next step | |
4 | Set values: sets the values. | |
5 | Clear values: shows which values are cleared. | Note that the nam of Client5 is cleared because the value in the source module was unknown |
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.