Testing Guidelines with the Rule Test Rig

Guidelines & Evaluations Last updated:

This area is available to users with guideline configuration access.

Opening the Rule Test Rig

The Rule Test Rig appears on the detail page of any non-exclusion guideline. To reach it:

  1. From the Guidelines list, click a guideline row to open its detail page.
  2. In the upper right of the detail page, click Test Rules. The page scrolls down to the Testing section, which contains the Rule Test Rig card.

You can also navigate directly to #guideline-test-rig in the URL to jump to the section.

Selecting a Rule Set

At the top of the Rule Test Rig, use the Rule set dropdown to choose which rules to test:

  • Initiation — tests whether a patient meets the criteria to start therapy
  • Continuation — tests whether a patient meets the criteria to continue an approved therapy

Filling in the Scenario Fields

The test rig presents a set of clinical input fields derived from the guideline’s rule conditions. Fill in values that represent the patient scenario you want to simulate. Common fields include:

  • Reference date — the date the evaluation should treat as “today” (defaults to the current date; change it to test time-based conditions)
  • Clinical observation values (lab results, diagnoses, medications) as required by the guideline’s rules

Fields vary by guideline. Required fields are marked; the Run button remains disabled until all required inputs are valid.

Running a Test

Click Run to evaluate the scenario against the selected rule set. The rig sends the scenario to the evaluation engine and returns the result in the Results section below the form. You see:

  • Outcome — whether the scenario passes or fails the rules
  • Rule breakdown — which individual conditions passed, failed, or were not evaluated
  • Reason text — a human-readable explanation of the determination

Saving a Test Case

After running a scenario you want to keep, click Save as test case. A dialog prompts you for a name for the case. Saved test cases appear in the list at the bottom of the Rule Test Rig.

Running All Saved Test Cases

Click Run all (N) to execute every saved test case for this guideline in sequence. The rig shows pass/fail results for each case side by side. Use this to verify that rule changes don’t break expected outcomes.