Versions Compared

Key

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

...

Beschreibung

The Der ActionHandler MatrixHandler can only be used in combination with the Rules Matrix. 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.

...

kann nur in Kombination mit dem Regelmatrix. 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

Code Block
com.dooris.bpm.actionhandler.MatrixHandler

Parameter

Parameter

Description

Beschreibung

Valid examples

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

Gültige Beispiele

matrixName

This parameter contains the name of the matrix being evaluated.

Decision

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

decision

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

The syntax is the following

Die Syntax lautet wie folgt:

COLUMNNAME~§~$

SPALTENNAME~§~${

VARIABLENAMECOLUMNNAME~§~${VARIABLENAME

VARIABLENNAME}~%~

If the search should be run for more than one value, the statement has to be repeated:

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

VARIABLENAME

VARIABLENNAME}~%~

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

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~%~

If more than one result is expected, the statement has to be repeated

Wenn mehr als ein Ergebnis erwartet wird, muss die Anweisung wiederholt werden.
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

...

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 'Department' eingetragen.

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.

...

Hier wird der Spaltenname 'Result' eingegeben, um das Ergebnis für den Suchwert anzuzeigen.

Result~§~result~%~

 

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

...

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

...

Die zweite Variable wird als Ergebnis festgelegt und entsprechend dem Wert "Department" aus der Spalte "Result" 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 Result 1 findet.

...