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

...

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

DescriptionBeschreibung

Valid examplesGültige Beispiele

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 soDieser 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}. The syntax is the followingDie Syntax lautet wie folgt:
COLUMNNAME~§~$SPALTENNAME~§~${VARIABLENAMEVARIABLENNAME}~%~

If the search should be run for more than one value, the statement has to be repeated:
COLUMNNAME~§~${VARIABLENAMEWenn die Suche nach mehr als einem Wert ausgeführt werden soll, muss die Anweisung wiederholt werden:
SPALTENNAME~§~${VARIABLENNAME}~%~COLUMNNAME_2~§~${VARIABLENAMEVARIABLENNAME}~%~

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 ResultDieser 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 repeatedWenn 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' nodeBeispiel

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

...

Parameter

DescriptionBeschreibung

ValueWert

matrixName

Name of the rules matrix we have createdder von uns erstellten Regelmatrix.

RulesMatrix

columnValueMapping

Column name ‘Department’ is entered here as the search value.

Department~§~${departmentAls Suchwert wird hier der Spaltenname 'Abteilung' eingetragen.

Abteilung~§~${Abteilung}~%~

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.

...

...

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.

...