You are here:
Automate Eligibility Determinations
Use Business Rules Engine to determine benefit eligibility and the benefit amounts for qualified applicants. First, create a decision matrix that defines the income threshold based on the income and household size. Then build an expression set that uses the matrix to find benefit eligibility and calculate eligible benefit amounts. Use Decision Explainer to share the reasoning behind application decisions, eligibility determinations, and benefit amount calculations with constituents.
Required Editions
| View supported product editions. |
| User Permissions Needed | |
|---|---|
| To create decision matrices and expression sets: | Rule Engine Designer |
| To create and edit Decision Explainer entities: | Decision Explainer Service Access |
Create a Decision Matrix to Calculate the Benefit Amount
Create a decision matrix that defines the income threshold based on the income and household size to calculate the benefit amount that applicants are eligible to receive.
- From the App Launcher, find and select Lookup Tables.
- Click New, and then select Decision Matrix.
- Click Next.
-
Specify these details.
-
For Name, enter CalculateBenefitAmount_NetIncomePointsTable.
Use this name for the decision matrix, because it’s referenced in the benefit application Omniscript.
- For Type, select Standard.
-
For Name, enter CalculateBenefitAmount_NetIncomePointsTable.
- Save your work.
- On the record page of the decision matrix, on the Related tab, click version 1 of the matrix.
-
To define your input and output data, add columns to the matrix.
- Click Add Column. For Column Header, enter HouseholdSize, for Header Type select Input, and for Data Type select Number.
- Click Add Column. For Column Header, enter ThreePointsLimit, for Header Type select Output, and for Data Type select Currency.
- Click Add Column. For Column Header, enter TwoPointsLimit, for Header Type select Output, and for Data Type select Currency.
- Click Done.
Important Use these column headers, which are referenced in the benefit amount expression set. You can change the values if necessary. -
Add these rows for input and output data values.
Input Data Output Data HouseholdSize (Number) ThreePointsLimit (Currency) TwoPointsLimit (Currency) 1 $1074 $1610 2 $1452 $2178 3 $1830 $2745 4 $2209 $3313 5 $2587 $3880 6 $2965 $4448 7 $3344 $5016 8 $3722 $5583 - Activate the decision matrix.
Build the Benefit Amount Expression Set
Create the benefit amount expression set from an expression set template.
- From the App Launcher, find and select Expression Set Templates.
- Select PSSExpCloud_CalculateBenefitAmount and then click Save As.
-
In the expression set builder, set the properties for the expression set version.
-
Click
, and then enter a start date time and an end date time for the expression set
version.
-
Enter a rank number.
Note When more than one enabled version matches an expression set call and the date-time periods overlap, the version with the highest rank is chosen. For example, if two enabled versions have the rank values 1 and 2, the version with rank 2 is chosen.
-
Click
- Save and activate the expression set.
Set Up Decision Explainer for Eligible Benefit Amount
Configure Decision Explainer to share the reasoning behind benefit application decisions, such as eligibility determination and benefit calculation, with constituents.
- Create explainability message templates for the PSSExpCloud_CalculateBenefitAmount expression set. For more information, see Create Explainability Message Templates.
- To show explanations to constituents, modify the expression set version configuration. For more information, see Show Rule Explanations to External Users.
- Create an application subtype definition. For more information, see Create Application Subtype Definitions.
-
Create a business process type definition. For more information, see Create Business Process Type
Definitions.
Next, define the metadata for the Decision Explainer business rule by creating an explainability action definition
- From Setup, in the Quick Find box, enter Decision Explainer, and then select Explainability Action Definition.
- Click New Explainability Action Definition.
-
For Label, enter BenefitApplicationLogs, and then press Tab to
autofill the developer name.
Important Use BenefitApplicationLogs for both the label and the developer name. -
For Business Process Type, click
,
and then select the business process type definition for this explainability action definition.
- For Application Type, select Public Sector.
- For Action Log Schema Type, select Expression Set.
- If necessary, enter a description.
-
For Application Subtype, click
, and
then select the application subtype definition for the explainability action definition.
-
Save your changes.
Next, define and store a version of the explainability action that your Decision Explainer business rule uses.
- From Setup, in the Quick Find box, enter Decision Explainer, and then select Explainability Action Version.
- Click New Explainability Action Version.
- For Label, enter a name.
-
Activate the explainability action version.
Note You can’t edit or delete active explainability action version records. -
For Explainability Action Definition, click
, and then select
BenefitApplicationLogs.
- If necessary, enter a description.
- Save your changes.
Build the Member Eligibility Expression Set
Use an expression set template to create the expression set that determines the benefit eligibility of a household member. To be eligible for benefits, the household member must be a US citizen.
- From the App Launcher, find and select Expression Set Templates.
- Select PSSExpCloud_MemberBenefitEligibility, and then click Save As.
-
In the expression set builder, set the properties for the expression set version.
-
Click
, and then enter a start date time and an end date time for the expression set
version.
-
Enter a rank number.
Note When more than one enabled version matches an expression set call and the date-time periods overlap, the version with the highest rank is chosen. For example, if two enabled versions have the rank values 1 and 2, the version with rank 2 is chosen.
-
Click
- Save and activate the expression set.

