---
schema_version: "1"
id: edee77c55a0f449460881655abf1813db25eb2dcf8f4fabef12a51cc01f907b4
title: Add Decision Explainer Messages to Prior Authorization Requests
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/bre_hc_add_decision_explainer.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.bre_hc_add_decision_explainer.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c2441d0287c76d62beac773150f3fc3c400c0460797e6415361d6d75501b2e09
description: Create expression set message templates where you add the success and failure explanation messages for the elements you want to show the explanations. Then, assign these templates to the respective elements in the Expression Set Builder.
products:
  - Industry Solutions
  - Cross Cloud
release: "264"
---
# Add Decision Explainer Messages to Prior Authorization Requests

Create expression set message templates where you add the success and failure explanation messages for the elements you want to show the explanations. Then, assign these templates to the respective elements in the Expression Set Builder.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col style="width:100%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong> and <strong>Unlimited</strong> Editions for clouds that have Business Rules Engine enabled</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d26903e67">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">To create and modify explainability message templates:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">Decision Explainer Service Access</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">To use explainability message templates in expression set steps:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">Rule Engine Designer</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">To run expression sets that have Decision Explainer enabled:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d26903e67 ">Rule Engine Runtime</td>

          </tr>
        </tbody>
      </table>

## Create Expression Set Message Tokens

1. From Setup, in the Quick Find box, enter Decision Explainer, and then select **Expression Set Message Token**.
2. Click **New Expression Set Message Token**.
3. Enter the expression set message token details.
    - Name: BenefitServiceCode.
    - Label: BenefitServiceCode.
4. Save your changes.

## Create Explainability Message Templates

1. From Setup, in the Quick Find box, enter Decision Explainer, and then select **Explainability Message Template**.
2. Click **New Explainability Message Template**.
3. Enter the explainability message template details.
    - Name: BenefitServiceCode\_Success.
    - Message: Prior authorization requirement for your service {BenefitServiceCode} is determined.
    - Expression Set Step Type: Decision Matrix Lookup.
    - Usage Type: Default. Label: BenefitServiceCode\_Success.
    - Result Type: Passed.
4. Save your changes.
5. Similarly, create these explainability message templates.
    
    | Name | Message | Expression Set Step Type | Usage Type | Label | Result Type |
    | --- | --- | --- | --- | --- | --- |
    | BenefitServiceCode\_Failure | Sorry! Prior authorization requirement for your service {BenefitServiceCode} could not be determined. | Decision Matrix Lookup | Default | BenefitServiceCode\_Failure | Failed |
    | MemberPlanStatus\_Success | Your Member Plan activation status is Active. | Calculation | Default | MemberPlanStatus\_Success | Passed |
    | MemberPlanStatus\_Failure | Your Member Plan activation status is Inactive. | Calculation | Default | MemberPlanStatus\_Failure | Failed |
    | Approve\_Success | This Member is Approved and PreAuthorised. | Calculation | Default | Approve\_Success | Passed |
    | Approve\_Fail | PreAuthorisation could not be determined for this member. | Calculation | Default | Approve\_Fail | Failed |

## Add Decision Explanations to Expression Set Elements

1. From the App Launcher ![App Launcher](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/resources-global/_corporate/images/app_launcher_icon.png), find and select **Expression Sets**.
2. Click **Member Plan Status Check**.
3. On the Member Plan Status Check expression set record page, click the **Member Plan Status Check V1** expression set version to open it in Expression Set Builder.
4. Click **Deactivate**.
    
    You must deactivate the expression set to make any changes.
5. Select the **Benefit Service Code** lookup table element.
6. Click ![Settings Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_settings_icon.png) on the left panel in the Expression Set Buildercanvas.
7. Select **Show decision explanation**.
8. Save your changes.
9. Click ![Builder Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_builder_icon.png) on the left panel in the Expression Set Builder canvas.
10. Select **Show decision explanation**.
11. In the Decision Explainer section, add these details.
    1. In When Step Returns Output, select **BenefitServiceCode\_Success**.
    2. In When Step Errors, select **BenefitServiceCode\_Failure**.
12. Click ![Settings Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_settings_icon.png) beside the When Step Returns Output field. Under Map Tokens, in BenefitServiceCode, select **ServiceCode**.
13. Click **Done**.
14. Click ![Settings Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_settings_icon.png) beside the When Step Errors field. Under Map Tokens, in BenefitServiceCode, select **ServiceCode**.
15. Click **Done**.
16. Save your changes.
17. Select the **Member Plan Active** calculation element, and click ![Builder Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_builder_icon.png) on the left panel.
18. Select **Show decision explanation**.
19. In the Decision Explainer section, add these details.
    1. In When Step Returns Output, select **MemberPlanStatus\_Success**.
    2. In When Step Errors, select **MemberPlanStatus\_Failure**.
20. Select the **Prior Authorization Approval** calculation element, and click ![Builder Icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_builder_icon.png) on the left panel.
21. Select **Show decision explanation**.
22. In the Decision Explainer section, add these details.
    1. In When Step Returns Output, select **Approve\_Success**.
    2. In When Step Errors, select **Approve\_Fail**.
23. Save your changes.
24. Click **Activate**.

## Simulate the Expression Set and View the Decision Explanation

Now, simulate the expression set and verify if the decision explanations you added earlier are appearing as expected. To simulate the expression set with context data, manually add the context input data as JSON inputs. Context data doesn’t hydrate automatically when you simulate an expression set.

1. From the App Launcher ![App Launcher](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/resources-global/_corporate/images/app_launcher_icon.png), find and select **Expression Sets**.
2. Click **Member Plan Status Check**.
3. On the Member Plan Status Check expression set record page, click the **Member Plan Status Check V1** expression set version to open it in Expression Set Builder.
4. Click **Simulate**.
5. Select **Advanced** as the input mode.
6. In the JSON Input box, remove any existing data and add this sample test input data manually. You can copy and paste this code in the JSON Input box.
    
    `{   "ServiceCode": "CPT23456",   "MemberNumberInput": "675858989",   "DateOfService": "2024-09-26",   "MemberPlan": [     {       "EffectiveDateTo": "2025-08-22",       "EffectiveDateFrom": "2024-08-22",       "PlanStatus": "Active",       "CoverageBenefit": [         {           "CoverageBenefitItem": [             {               "IsPreauthorizationRequired": "false",               "CoverageBenefitItemName": "XYZ",               "ServiceTypeCode": "CPT23456"             }           ]         }       ],       "MemberNumber": "675858989"     }   ] }`
7. Click **Simulate**.
8. From the **Detailed View** dropdown, select **Concise View**.
    
    ![Simulation View Options](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_sg_hc_detailed_view.png)

You can now view the decision explanations for the Benefit Service Code lookup table element, and the Member Plan Active and Prior Authorization Approval calculation elements. The decision explanations are determined for the service code CPT23456 that was provided as input.

![Decision Explanation Details](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/bre_sg_hc_decision_explanation.png)