====== MatrixHandler ======
==== Description====
This handler can only be used in combination with the [[en:software:tim:rules_matrix | Rules Matrix ]]. The handler searches for matches in the matrix. The search values are defined by the parameters. The evaluation takes places based within the [[en:software:tim:rules_matrix | Rules Matrix ]]. For the following parameter examples, the example from this entry will be used: [[software:tim:rules_matrix | Rules Matrix ]].

------
==== Action Class ====
<code>
com.dooris.bpm.actionhandler.MatrixHandler
</code>
\\
----
==== Event Type ==== 
any
==== Action Name ==== 
any
==== Mandatory Fields ==== 
none
----
==== Parameter ==== 
== matrixName ==
This parameter contains the name if the matrix being evaluated.
Explanation ([[#Example]])

\\ == 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:
<code>COLUMNNAME~§~SEARCHED_VALUE~%~</code>
If the search should be run for more than one value, the statement has to be repeated:
<code>COLUMNNAME~§~SEARCHED_VALUE~%~COLUMNNAME_2~§~SEARCHED_VALUE_2~%~</code>
Explanation ([[#Example]])

\\ == 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 [[software:tim:rules_matrix#spalten_definieren | Result]].
<code>COLUMN_NAME~§~VARIABLE_NAME~%~</code>
If more than one result is expected, the statement has to be repeated.
<code>COLUMN_NAME~§~VARIABLE_NAME~%~COLUMN_NAME_2~§~VARIABLE_NAME_2~%~</code>
----

==== Example====
=== Flowcharter ===

{{  :software:tim:matrix_handler.png?800  }}

=== Webclient ===

{{  :software:tim:actionhandler:matrixhandlerweb1.png?400  }}{{  :software:tim:actionhandler:matrixhandlerweb2.png?400  }}

----