You are here:
Call a Decision Matrix from an Integration Procedure
To call a decision matrix from an Integration Procedure, and return the specified matrix’s results to the Integration Procedure, use the Decision Matrix Action.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions for clouds that have Business Rules Engine enabled |
| User Permissions Needed | |
|---|---|
| To access Omnistudio to create and modify an Integration Procedure: | Omnistudio Admin |
| To access Business Rules Engine to create and activate a decision matrix version: | Rules Engine Designer |
| To call a decision matrix from an Integration Procedure: | Omnistudio Admin |
You can call only active decision matrices from an Integration Procedure.
-
From the App Launcher (
), find and select Omnistudio.
- From the app navigation menu, select Omnistudio Integration Procedures.
- Select an Integration Procedure, and then select the version that you want to modify.
- From the Actions panel, drag Decision Matrix Action onto the Structure panel.
-
In the Decision Matrix Properties section, specify these decision matrix action
properties:
Field Description Matrix Input Parameters: Data Source The name of a data JSON node in the Integration Procedure that contains a value to pass to the decision matrix. Matrix Input Parameters: Filter Value The name of the corresponding decision matrix input variable that accepts the value. Matrix Name The name of the decision matrix that you want to call. Remote Options Additional options to pass to the Decision Matrix. These options are predefined, but you can also pass options specific to the matrix.
executionDateTime— Sets the Effective Date of the Decision Matrix.
Default Matrix Result Value to return if the Decision Matrix returns null For example, if the name of your decision matrix is StudentDiscountEligibility, and the input variables that the matrix takes are
AgeandGPA, then enter these values:- Matrix Name: StudentDiscountEligibility
- Matrix Input Parameters:
Data Source Filter Value Age Age GPA GPA
- From the Actions panel, drag the Response Action component, and place it below the Decision Matrix Action in the Structure panel.
-
Enter these properties:
- Send JSON Path: Enter the element name of the Decision Matrix Action. This path is used as the JSON node to store the data.
- Send JSON Node: Specify a new name for the parent node in the outgoing request. For example, my_output.
- Click Preview.
-
In the Input Parameters panel, add Key/Value pairs.
For example:
Key VALUE Age 16 GPA 3.5 -
Click Execute.
Here’s what the output looks like:
{ "my_output": { "result": [ { "Qualified": true } ] } }
Did this article solve your issue?
Let us know so we can improve!

