Versions Compared

Version Old Version 4 New Version 5
Changes made by

Betül Kara (Deactivated)

Betül Kara (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
com.dooris.bpm.actionhandler.MatrixHandler

Parameter

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

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 smartform 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.

...