====== MatrixHandler ======

==== Beschreibung ====

Dieser Handler wird in Kombination mit der [[:software:tim:rules_matrix|Rules Matrix ]] verwendet. Hierbei werden mehrere Suchwerte übergeben. Stimmen die Suchwerte mit einer Regel überein, werden ein oder mehrere Ergebnisse zurückgegeben. Die Auswertung findet anhand der definierten [[:software:tim:rules_matrix| Rules Matrix ]] statt. Für die Parametrisierung wird nun das Beispiel aus dem Wiki-Eintrag [[:software:tim:rules_matrix| Rules Matrix ]] verwendet.

----

==== Klasse ====

<code>
com.dooris.bpm.actionhandler.MatrixHandler
</code>

----

==== Event Type ====

beliebig

==== Action Name ====

beliebig

==== Mandatory Fields ====

leer

----

==== Parameter ====

== matrixName ==

Hier wird der Name der Matrix übergeben aufgrund welcher die Auswertungen gemacht werden. Erklärung (siehe [[#beispiel|Beispiel]])

== columnValueMapping ==

Hier müssen die verschiedenen Suchspalten und deren Werte, nach welchen gesucht werden soll, angegeben werden. Die Spaltennamen sowie die Inhalte können aus Prozessvariablen kommen. Diese müssen dann ${NAME_DER_VARIABLE} geschrieben werden. Die Syntax ist die folgende:

<code>
SPALTENNAME~§~GESUCHTER_WERT~%~
</code>

Soll nach mehr als einem Wert gesucht werden, so muss dieser Term mehrfach wiederholt werden. Z.B.

<code>
SPALTENNAME~§~GESUCHTER_WERT~%~SPALTENNAME_2~§~GESUCHTER_WERT_2~%~
</code>

Erklärung (siehe [[#beispiel|Beispiel]])

== columnResultMapping ==

Hier werden die Prozessvariablen angegeben, in welchen die Ergebnisse abgelegt werden sollen. Ebenfalls muss hier die Spalte angegeben werden in welcher das Ergebnis innerhalb der Matrix zu finden ist. Der [[:software:tim:rules_matrix#spalten_definieren|Spaltentyp]] muss hierbei ein "Result" Typ sein.

<code>
COLUMN_NAME~§~VARIABLE_NAME~%~
</code>

Wird mehr als ein Ergebnis ausgegeben so muss wiederum der gesamte Term wiederholt werden.

<code>
COLUMN_NAME~§~VARIABLE_NAME~%~COLUMN_NAME_2~§~VARIABLE_NAME_2~%~
</code>

----

==== Beispiel ====

=== Flowcharter ===

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

=== Webclient ===

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

----

==== Abhängigkeiten ====