Rule Testing

Validate rules with saved Test cases and repeatable Test Suites.

Rule Testing lets you verify rule behavior against saved scenarios. Each scenario uses fixed input and expected output. You can rerun the same checks after any change.

This page provides a focused view of tests for an individual rule. To manage your tests from a global workspace view, navigate to the main Tests section.: Tests

Main benefits

• Validate rule changes before release.

• Catch unwanted side effects early.

• Recheck rules after a DecisionRules update.

• Understand rule behavior faster with real examples.

• Compare results between solver versions before switching.

Rule Testing vs. Test Bench

• Test Bench: Used for ad-hoc checks while actively editing a rule.

• Rule Testing: Used for saved, repeatable validation.

Core concepts

Test

The smallest testing unit. It stores:

• Name

• Rule reference (Alias and Version)

• Rule strategy

• Input data

• Expected output

• Ignored output properties (Optional: Used to exclude dynamic values like current dates or generated IDs from the validation).

Test Suite

A Test Suite is a collection of Tests. You can think of it as a folder for related scenarios.

A Test Suite is linked to a rule by:

• Rule alias

• Rule version

This makes the Test Suite specific to one rule version.

In rare cases, a Test Suite can point to a rule that no longer exists. These Tests are marked as Orphaned Tests.

Test Runs

After execution starts, Test Run is created with state Waiting. During processing, it can also be Running.

Finished Test Runs can end as:

• Passed

• Failed

• Error

• Canceled

What users can do

Rule Testing covers three main areas:

1. Rule-level Test management

2. Space-level Test management

3. Test Bench integration

Rule-level Tests tab

Rule Testing adds a Tests tab next to Model and Designer.

Rule tabs

This tab is the main place to manage Tests for the opened rule. It shows all Test Suites and Tests linked to that rule.

Main actions

Users can:

• Create a new Test / Edit a Test

• Create a new Test Suite / Edit a Test Suite

• Filter by name

• Run all / Run selected

• Сhoose which one to run on (If the space offers more than one solver version)

If nothing is selected, the run action offers Run all. If the user selects one or more items, it will execute selected one.

Test Detail Panel

User can modify test in Test Detail window.

Run Test

Test Run is created for selected Test.

Load to Test Bench

Users can copy test input directly into Test Bench. This makes failed tests easier to debug.

Rule-level Test Runs overview

The left-side Test Runs panel focuses on execution results and debugging. Panel shows all Test Runs belongs to current rule. If user clicked on one Test Run, detail is shown.

Test Runs panel

Test Run detail

Test Suites are collapsed by default. Users can expand a Test Suite to see its Tests.

Test Run detail

Users can expand a test to inspect:

• Input data

• Expected output

• Received output

• The solver version the run used

Differences in received output are highlighted.

Output differences

Available actions

From the left panel, users can:

• Open Test details

• Inspect Test in Test Bench

Test Bench integration

Rule Testing integrates directly with Test Bench. Thera are few possibilities that can be shown.

Save as test

After running a rule in Test Bench, users can choose Save as Test. This opens dialog with the current input and output already available. The user then fills in:

• target Test Suite

• name

Existing test match

If the current Test Bench input matches an existing test, the interface shows it. It also shows whether the current output matches the expected output. If multiple tests match the same input, infoo is shown

Updating expected output

If the input matches a saved test but the output differs, the user can update the test.This action ask for confirmation before replacing the expected output.

Import and export

Tests and Test Suites can be exported as JSON. Tests associated with rules are also included when exporting an entire folder or Space.

Export Space dialog with options for exporting Space content, including associated tests

Export Folder dialog with options for exporting folder content, including associated tests

Tests can be imported to a Space, rule, or Test Suite.

Tests are not included when exporting an individual rule. To export a rule together with its tests, export the folder containing the rule or the entire Space.

Orphaned Tests

Orphaned Tests exist when the stored alias and version do not match any existing rule. Orphaned Tests can be shown in the space-level menu. Users can then move those tests to an existing rule.

Rule Testing vs. Test Bench

Test Bench is best for ad-hoc checks while editing a rule. Rule Testing is best for saved and repeatable validation. Use Test Bench to explore. Use Rule Testing to verify.

Automation

If you want to run tests programmatically, use the Rule Testing API.