Versions Compared

Key

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

...

Description

Der The ActionHandler MatrixHandler kann nur in Kombination mit dem can only be used in combination with the 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.

...

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.

...

Class

Code Block
com.dooris.bpm.actionhandler.MatrixHandler

Parameter

Parameter

BeschreibungDescription

Gültige BeispieleValid examples

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 werdenThis 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 so: ${NAME_DER_VARIABLE}. Die Syntax lautet wie folgtThe syntax is the following:
SPALTENNAME~§~$COLUMNNAME~§~${VARIABLENNAMEVARIABLENAME}~%~

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

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 werdenThis 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.
COLUMN_NAME~§~VARIABLE_NAME~%~

Wenn mehr als ein Ergebnis erwartet wird, muss die Anweisung wiederholt werdenIf more than one result is expected, the statement has to be repeated.
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' implementiertExample

We have a simple example to explain the usage of this actionhandler. We have implemented this actionhandler on the 'task1' node.

...

Parameter

BeschreibungDescription

WertValue

matrixName

Name der von uns erstellten Regelmatrixof the rules matrix we have created.

RulesMatrix

columnValueMapping

Als Suchwert wird hier der Spaltenname 'Abteilung' eingetragen.

Abteilung~§~${AbteilungColumn name ‘Department’ is entered here as the search value.

Department~§~${department}~%~

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.

...

...

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.

...