MatrixHandler

Description

The ActionHandler MatrixHandler can only be used in combination with the https://tim-doc.atlassian.net/wiki/spaces/eng/pages/228003033. The handler searches for matches in the matrix. The search values are defined by the parameters.

If the search values match a rule, one or more results will be returned. The evaluation takes place based on the Rules Matrix. For the following parameter examples, the example from this entry will be used: Rules Matrix.

Class

com.dooris.bpm.actionhandler.MatrixHandler

Parameter

Parameter	Description	Valid examples

Parameter

Description

Valid examples

matrixName

This parameter contains the name of the matrix being evaluated.

Decision

columnValueMapping

Here the different search columns and the searched values have to be defined. The column names and values can come from process variables. They have to be declared like so: ${NAME_DER_VARIABLE}. The syntax is the following:
COLUMNNAME~§~${VARIABLENAME}~%~

If the search should be run for more than one value, the statement has to be repeated:
COLUMNNAME~§~${VARIABLENAME}~%~COLUMNNAME_2~§~${VARIABLENAME}~%~

COLUMNNAME_1~§~${variable_1}~%~
COLUMNNAME_2~§~${variable_2}~%~

columnResultMapping

This parameter defines the process variables in which the results are saved. The column in which the results are found within the matrix is also noted here. The column type must be set to Result.
COLUMN_NAME~§~VARIABLE_NAME~%~

If more than one result is expected, the statement has to be repeated.
COLUMN_NAME~§~VARIABLE_NAME~%~COLUMN_NAME_2~§~VARIABLE_NAME_2~%~

name~§~result~%~

Example

We have a simple example to explain the usage of this actionhandler. We have implemented this actionhandler on the 'task1' node.

Parameter	Description	Value

Parameter	Description	Value
`matrixName`	Name of the rules matrix we have created.	`RulesMatrix`
`columnValueMapping`	Column name ‘Department’ is entered here as the search value.	`Department~§~${department}~%~`
`columnResultMapping`	Column name ‘Result’ is entered here to show the result for the search value.	`Result~§~result~%~`

We have an already populated matrix under the Rules Matrix section under the administration tab as follows:

We have a form with two fields. First variable is set as department. When the user fills out the department variable, the result field will be filled automatically via the help of the rules matrix.

Second variable is set as result and will be taken from the Result column according to the Department value.

We will start the process instance by filling out the department field.

After entering the department name and starting the process instance, the actionhandler will be executed.

You can see that handler finds the value for the IT as Result 1.