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.

Context

First of all, you got the context part (See the picture below).

data output mapping 1

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.

Mapping

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).

data output mapping 2

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

data output mapping 3

will gives you the following context and mapping

data output mapping 4

Default 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.

How to use this functionality ?

For example, lets say that we want to do a one to one mapping.

  1. Navigate in the right column for each output data associations and select the "Literal Expression" logic.

    data output mapping 5

  2. Then in each literal expression, just write the name of the element from your current context you wanna assign to the output data association.

    data output mapping 6

  3. (Optional) If you want you can use the FEEL language to add some transformation to your data.

    data output mapping 7

  4. Then your mapping is done, congratulations !

  5. 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.

    data output mapping 8

Multi instance mapping

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.

data output mapping 9

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).

data output mapping 10

We still can also use the FEEL language function with it if we want to transform the data.

data output mapping 11