Use Data Mapper Activity

The data mapper activity is used to assign the value of a process data object, predefined variable, or literal to another data object or variable within the process. It can be used in scenarios where it is not possible to assign values to certain data attributes through other activities in your process or to override the values assigned to attributes through the defined process flow.

To define data mappings through the Data Mapper:

  1. On the Activities palette, expand System and drag and drop a Data Mapper activity onto the process flow.
  2. Select the Data Mapper activity, click Menu icon, and select Open Data Association.
    The Data Association editor opens. Notice that the editor contains only the Output tab because the Data Mapper is just a mapper that serves to associate one process data object or variable with another. Unlike other activities (for example, human tasks), it does not have data objects of its own that require mapping with the process data on the input side.
  3. In the editor, drag and drop elements from the left and right panes onto the center pane to map associations. Both the panes display all the available data objects or variables within the process. The object you add on the left serves as the source and the object on the right denotes the target of the mapping. The following figure shows a sample data mapping:

    Description of data-mapping.png follows
    Description of the illustration data-mapping.png

    Here, the value of a form data object, customername is assigned to another form data object name, and a literal value of “Paris” is assigned to a form data object, city.


    If you chose a predefined variable as the target, ensure that it isn’t read only.
  4. Optionally, use the Expression Editor to build an input expression using standard functions and operators.
  5. Click Apply to save the data mappings.

To define data associations through other activities, such as human task or service activities, see Configure Data Association.