Decision matrix definition

A decision matrix definition is composed of two areas:

  • The matrix parameters

    Together with the matrix name the matrix parameters define the matrix interface. When this matrix is used in a workflow, you must provide the values for all input parameters. The matrix output parameters can be mapped to workflow parameters, or can be ignored.

  • The matrix rules

    A set of rules to be evaluated on the input parameters to determine values for the output parameters.

Decision Service

Create a decision table to calculate the shipping fee and whether insurance is required for sending a package, based on its weight and value. This table shows the parameters that are required for the workflow:

Parameter Data Type
Weight Decimal
Value Decimal
Insurance Boolean
ShippingFee Decimal

This table shows a possible decision table for this workflow:

Parameters to check Parameters to set
Weight Value Insurance ShippingFee
<= ‘800.0’ < ‘150.0’ False 3.5
> ‘800.0’ < ‘150.0’ False 12.0
>= ‘150.0’ True 20.0

At evaluation time, these are possible results:

  • For a package with Weight 700 and Value 120, no Insurance is required and ShippingFee is 3.5.
  • For a package with Weight 500 and Value 170, Insurance is required and ShippingFee is 20.

Defining a matrix

The DECISIONSERVICE-Editor role is required.

To define a matrix, first specify the matrix name and input parameters. Then add the matrix rules.

  1. Click Add on the Matrices page to create a new matrix. Or, open the details of an existing matrix to create a new version of this matrix.
  2. When you click Add, you must choose the matrix type Approval Matrix or Decision Matrix.
  3. On the left side panel of a matrix, specify this information:
    Name
    A matrix name can contain only letters, digits, and underscore (_). A name cannot be longer than 255 characters. After a matrix is approved and it becomes active in the runtime, its name cannot be changed anymore.
    Description
    Explain the purpose of this matrix. A description can have maximum 4000 characters.
    Versions widget
    To show information about the current and previous active versions of the matrix. For each version, this is shown:
    • Status.
    • Time when the matrix was last saved or approved.
    • The name of the user who last saved or approved this version.