Description

The VariableDecisionHandler allows the user to pre-define the process path after an XOR gateway based on process variables.

The VariableDecisionHandler was previously called SmartformDecisionHandler. However, it is still accessible via the class: com.dooris.bpm.actionhandler.SmartFormDecissionHandler.

Class

com.dooris.bpm.actionhandler.VariableDecisionHandler

Parameter of the XOR gateway

Parameter	Default value	Description
`variableName`MANDATORY	N/A	Name of the process variable stored in the smartform, based on whose value a process path is chosen. Good to know Alternatively, you could use the parameter name `processVariable` instead of `variableName`. Both parameter names work the same. Avoid adding both parameter names at once for the same XOR gateway. If both are given, only the value of `variableName` will be considered, while the value of `processVariable` will be ignored.
`defaultTransition`	N/A	This parameter defines which process path will be selected if the process variable is not defined.

Parameter of the outgoing sequence flows

For each condition, there will be one Output parameter with a Name for the parameter and an ID:

Name	ID	Description
`Yes`		Insert here the value of the Output variable, if the condition will apply for `yes`.
`No`		Insert here the value of the Output variable, if the condition will apply for `no`.

Parameter

Default value

Description

condition expression

The condition expression can be set arbitrarily but should fit the decision. For example:

Decision: Proposal status?
Condition 1: Approved
Condition 2: Declined

(e.g. proposal status? Condition expression 1: Approved. Condition expression 2: Declined).

ID

The ID is the value of the process variable set in the smartform (value=“ID”).

Example

We want to decide between the two different paths in the workflow based on a user selection from the smartform.

In our example, we want to send two different emails depending on whether the approval was given or declined in the smartform on the previous task.

Smartform

In this example, VariableDecisionHandler is added at the XOR node. Smartform is created for this workflow with a radio button which has a name decision as a variable name. Radio button setting is in the below screenshot. decision variable is used for VariableDecisionHandler which defines the routes after XOR gateway.

Parameter	Example
`processVariable`	`decision`

Output	Example
`Yes`	`yes`
`No`	`no`

The smartform created for this example: