Mapping operators
You can add mappings to activities in order to:
- Populate the fields in an activity form with existing or default values. For example, you might want to populate the fields of a form activity with the existing attribute values so that users can see what is currently stored and make changes as required.
- Set attribute values as part of an activity that is performed automatically (i.e. without user input). For example, when triggering the "Send email" system service from another activity, you might want to populate the values required to create the new system service case automatically with data from the parent case rather than requiring a user to fill in and submit a form.
You can use the global mappings on activities to populate the activity form with existing attribute values (All casedata > All task in) and to update the attribute values with the data from the activity form (All task out > All casedata). These global mappings use the default mapping operator, = to populate the form field or attribute with the source value.
As an alternative or in addition to these global mappings, you can add mapping rules for specific fields. When you add a mapping rule, you can select a different operator in order to to add or remove values, or perform mathematical operations. The supported operators depend on the data type of the field or attribute.
Single value attributes
| Operator | Name | Supported data types | Description |
|---|---|---|---|
| = | Equal to | All except Money | Replace any existing value with the specified value. |
| += | Add | Strings and numerical data* | Numerical data: Add the specified value to the existing value. Strings: Append the specified value to the existing value (i.e. concatenate the strings). |
| -= | Subtract | Numerical data* | Subtract the From value from the existing value. |
| *= | Multiply | Numerical data* | Multiply the existing value by the From value. |
| /= | Divide | Numerical data* | Divide the existing value by the From value. |
* Numerical data includes integers, longs, doubles, and single currency money. Note that if the data type is integer or long, results of calculations will be rounded up or down to the nearest whole number. For more information about data types, see Attributes.
Multivalue attributes
For data types that support multiple values (such as strings, case IDs, integers), you can use the following mapping operators:
| Operator | Name | Supported data types | Description |
|---|---|---|---|
| = | Equal to | All | Replace all existing values with the specified value. |
| += | Add | Strings, files, case IDs, and numerical data | Add the specified value as a new entry to the set or list of values. If the specified value is already present in a set, no change is made. |
| -= | Subtract | Strings, case IDs, and numerical data | Remove the specified value from the set or list of values. If the specified value is not present, no change is made. Note that this mapping operator is not supported for multivalues of files. |
To add or remove multiple values to/from a multivalue field, either specify the values as a comma-separated list enclosed in square brackets (e.g. [10, 20, 30] or [lemons, oranges, limes]) or add multiple mapping rules for the same field.