MatrixHandler

Beschreibung

Der ActionHandler MatrixHandler kann nur in Kombination mit dem Rules Matrix. Der Handler sucht in der Matrix nach Übereinstimmungen. Die Suchwerte werden durch die Parameter definiert.

Wenn die Suchwerte mit einer Regel übereinstimmen, werden ein oder mehrere Ergebnisse zurückgegeben. Die Auswertung erfolgt auf Basis der Regelmatrix. Für die folgenden Parameterbeispiele wird das Beispiel aus diesem Eintrag verwendet: Regelmatrix.

Klasse

com.dooris.bpm.actionhandler.MatrixHandler

Parameter

Beschreibung

Gültige Beispiele

matrixName

Dieser Parameter enthält den Namen der Matrix, die ausgewertet wird.

Entscheidung

columnValueMapping

Hier müssen die verschiedenen Suchspalten und die gesuchten Werte definiert werden. Die Spaltennamen und -werte können aus Prozessvariablen stammen. Sie müssen wie folgt deklariert werden: ${NAME_DER_VARIABLE}. Die Syntax lautet wie folgt:
SPALTENNAME~§~${VARIABLENNAME}~%~

Wenn die Suche nach mehr als einem Wert ausgeführt werden soll, muss die Anweisung wiederholt werden:
SPALTENNAME~§~${VARIABLENNAME}~%~COLUMNNAME_2~§~${VARIABLENNAME}~%~

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

columnResultMapping

Dieser Parameter definiert die Prozessvariablen, in denen die Ergebnisse gespeichert werden. Auch die Spalte, in der sich die Ergebnisse innerhalb der Matrix befinden, wird hier vermerkt. Der Spaltentyp muss auf Ergebnis gesetzt werden.
COLUMN_NAME~§~VARIABLE_NAME~%~

Wenn mehr als ein Ergebnis erwartet wird, muss die Anweisung wiederholt werden.
COLUMN_NAME~§~VARIABLE_NAME~%~COLUMN_NAME_2~§~VARIABLE_NAME_2~%~

name~§~result~%~

Beispiel

Wir haben ein einfaches Beispiel, um die Verwendung dieses Actionhandlers zu erklären. Wir haben diesen Actionhandler auf dem Knoten 'task1' implementiert.

Parameter	Beschreibung	Wert
`matrixName`	Name der von uns erstellten Regelmatrix.	`RulesMatrix`
`columnValueMapping`	Als Suchwert wird hier der Spaltenname 'Abteilung' eingetragen.	`Abteilung~§~${Abteilung}~%~`
`columnResultMapping`	Hier wird der Spaltenname 'Ergebnis' eingegeben, um das Ergebnis für den Suchwert anzuzeigen.	`Ergebnis~§~Ergebnis~%~`

Wir haben eine bereits ausgefüllte Matrix im Abschnitt "Regelmatrix" auf der Registerkarte "Administration" wie folgt:

Wir haben ein Smartform mit zwei Feldern. Die erste Variable wird wie folgt festgelegt: Abteilung. Wenn der Benutzer die Abteilungsvariable ausfüllt, wird das Ergebnisfeld automatisch mit Hilfe der Regelmatrix gefüllt.

Die zweite Variable wird als Ergebnis festgelegt und entsprechend dem Wert "Abteilung" aus der Spalte "Ergebnis" entnommen.

Wir starten die Prozessinstanz, indem wir das Abteilungsfeld ausfüllen.

Nach Eingabe des Abteilungsnamens und Start der Prozessinstanz wird der Actionhandler ausgeführt.

Sie können sehen, dass der Handler den Wert für die IT als Ergebnis 1 findet.