Map Process Data action
Use Map Process Data action to assign (map) value to a process variable.
A process variable is a placeholder for data that can be accessed throughout the lifecycle of a process. It is how data is transferred between actions in a process.
Process variables can receive values:
- When defining a process variable, in Default value (see Working with process variables article).
- When manually kicking off a process, for process variables marked as input (see Running a process flow article).
- When scheduling a process, for process variables marked as input (see Scheduling a process article).
- Within the process, using Map Process Data action.
You can use Map Process Data to either give values to your process variable or to change the value of the process variable.
A process variable can be mapped to:
- a constant value
- a dynamic value (coming from another process variable)
How to configure the Map process data action?
Go to the Process Designers section and open a new or an existing process. Actions configuration can be performed once they are dragged and dropped on canvas.
Step 1: Drag the Map Process Data action from Toolbar and drop it on canvas; click on the action to open the Properties Panel.
Step 2: You can edit the Action Name.
Step 3: Click on Map Process Data (not configured) card to go to the configurations steps.
Step 4: Map process data configuration
- you can assign to a process variable a constant value or a dynamic value (coming from another process variable). When the action is executed, data is assigned to your process variable.
- press +Add variable and the selector will open displaying the available process variables
- on the left side, select the process variable you want to assign new value to
- on the right side, insert new value or a process variable from which it will receive new value.
You can assign values to multiple process variables at once in Map Process Data action.
Consider that data types must match when assigning values to process variables. Exception: String is the only data type that accepts all other data types.