Data Output Mapping
The Data Output Mapping allows you to define the data transformation for Data Output Associations connected to the selected shape with her inner data output.
First of all, you got the context part (See the picture below).
The context is defined by all the inner data outputs of the shape. Those outputs could be read only when they are provided by an operation bound on a task. In that case, you won’t be able to edit, delete them or even create a new one unless you are doing that via editing the operation bound in the Operation library.
Each element listed in the context can be edited, deleted or you can access to their details information. You can also create new context element.
When you have your context filled with the wanted elements, you can now do your data transformation using the mapping field (see the picture below).
In the left column we have the output data associations which need to me map to one element of your context. Those associations are defined by data object or data output connected to the selected task. You can also create new ones and manage them as you please. In the right column you have the mapping expression, each associations have its own.
For example the following diagram
will gives you the following context and mapping
When you don’t specify any mappings, the tool does some default mapping depending on the type of the task, the outputs that are linked by data associations and the name of those outputs. The default mapping is equal to null when there are no matched outputs.
The default mapping value is displayed at the bottom of the row of the value of the mapping or if a Literal Expression was selected, it will appear as placeholder on the value.
For example, lets say that we want to do a one to one mapping.
Navigate in the right column for each output data associations and select the "Literal Expression" logic.
Then in each literal expression, just write the name of the element from your current context you wanna assign to the output data association.
(Optional) If you want you can use the FEEL language to add some transformation to your data.
Then your mapping is done, congratulations !
If you want to clear the mapping you can use the button "Clear" at the end. This will clear all the input mapping! If you want to just clear one of them, click on the expression and use the clear functionality of the logic.
When your task, call activity, sub-process has the MI parallel loop or MI sequential loop (cf. Multi instance Loop Details) attribute enabled, you will have a new section in your data output mapping modal.
The "Resulting collection" dropdown will allows you to choose a connected data object or data output with a data type which is a collection. The "Collected variable" field is used to map the representation of an item of the collection with an element from your context.
For example if I have in my context a inner data output called "Updated" which is a string and my collection is named "List of updated names" which is a collection of string. Then I will be able to use my variable "Updated" to map, define the item variable of the resulting collection (see the picture below).
We still can also use the FEEL language function with it if we want to transform the data.