This page is not fully translated, yet. Please help completing the translation.
(remove this paragraph once the translation is finished)

Rules Matrix

The Rules Matrix is used für evaluation of Business Rules. It is possible to create different matrixes with custom columns. Afterwards the matrix gets filled with rows. These rows can be evaluated with the help of an actionhandler. The row with the best match will be used as the result row. If not all columns match exactly, the row with the next best result is used.

Creating a Matrix

A matrix can be created in the administrationsclient . In order to see the corresponding tab, the current user must have the role rulesadministrator.

With “Add Matrix” it is possible to create a custom number of matrixes. When clicking, a new popup is opened in which the structure of the matrix can be defined. First the matrix needs a name, in this example “decision”. Also the owner group of the matrix has to be defined. All users in this group are able to see the matrix und to change it. Only groups in which the current user is member are shown.

Define Columns

For the next step number of columns has the created. Every column needs a name and a coumn type. A column type defines the type of the content. Normal column types are used for evaluation and “result” column types are used for results and are not considered for the evaluation. There are different column types:

Column Type	Description
STRING	A normal characterband where text can be defined.
RESULT_STRING	Result column / A normal characterband where text can be defined.
LONG	This column is for integers.
RESULT_LONG	Result column / This column is for integers.
FLOAT	This row is for floating decimals.
RESULT_FLOAT	Result column / This row is for floating decimals.
BOOLEAN	This column is for true or false values.
RESULT_BOOLEAN	Result column / This column is for true or false values.
IDENTITY	This column is for users that are created in the system.
RESULT_IDENTITY	Result column / This column is for users that are created in the system.

The following example shows a matrix with 3 columns, which should be searched. Each column has a different column type. There is also a result column in which a user will the evaluated result.
After click on “save” the matrix is created and can now be filled with values.

Filling the matrix

The following image shows a already filled matrix. In this view it is possible to delete the hole matrix, to edit it, add new lines and to delete lines.

Element	Description
1	With this button the hole matrix can be deleted.
2	This view shows the matrix with all the filled values.
3	Wit this button the matrix can be edit. It is not possible to change the column type of exisiting columns. But they can be deleted an newly added.
4	With this button it is possbible to delete rows.
5	Here you can add new lines.

If one wants to add a new row , a pop-up appears. Depending on the column type various fields are shown. For string , for example, a simple box . In Identity is a list of all users displayed . A list with true or false is displayed when using Boolean.

If you select a star “*”, this is seen as a Wildcard and any value will be seen as match.

Using the matrix per Actionhandler

Using the matrix per Actionhandler is described here: MatrixHandler

Evaluationexamples

The filled example matrix from the top is the base for these exampe evaluations. We have 3 searching values and one result column. The following table shows the results of some fictitious evaluations. The following rules are applied:

The line with the best match is seen as result.

If more than one line match, the first match from the top is the result.

Search Value 1	Search Value2	Search Value3	Result
Freising	true	20	Group_1
Freising	true	89	wiki
Freising	false	20	Group_1
Freising	false	8267	Group_1
München	true	213	Prozess Manager
Timbuktu	false	89	wiki