Work with test results

Published

May 12, 2025

Once generated via the ValidMind Library, view and add the test results to your documentation in the ValidMind Platform.

Prerequisites

Add test results

  1. In the left sidebar, click Inventory.

  2. Select a model or find your model by applying a filter or searching for it.3

  3. In the left sidebar that appears for your model, click Documentation, Validation Report, or Ongoing Monitoring.

  4. Click on a section header to expand that section and add content.

  5. Hover your mouse over the space where you want your new block to go until a horizontal dashed line with a sign appears that indicates you can insert a new block:

    A gif showing the process of adding a content block in the ValidMind Platform

    Adding a content block in the ValidMind Platform
  6. Click and then select Test-Driven4 under from library.

    • By default, the Developer role can add test-driven blocks within model documentation or ongoing-monitoring plans.
    • By default, the Validator role can add test-driven blocks within validation reports.
  7. Select test results:

    • Choose from available VM Library (out-of-the-box) or Custom tests under test-driven in the left sidebar of the test selection modal.
    • Use Search by name on the top-left to locate specific test results.

    A screenshot showing several test-driven blocks that have been selected for insertion

    Test-driven blocks that have been selected for insertion

    To preview what is included in a test, click on it. By default, the actively selected test is reviewed.

  8. Click Insert # Test Results to Document when you are ready.

  9. After inserting the results into your document, click on the text to make changes or add comments,5 or configure what is displayed on the test result.6

Configure test result displays

Once added to your model documentation, validation reports, and ongoing monitoring reports, configure how the logged test results are displayed:

  1. Locate the test result whose display you want to configure, and hover over it until the result block’s toolbar appears in the top right-hand corner.

  2. Select Configure and toggle the following options on or off as desired:7

    • hide title — Title
    • hide text — Description
    • hide parameters — Parameters
    • hide tables — Tables
    • hide figures — Figures
7 
Options displayed for each test result will depend on what was logged via the ValidMind Library for your test.

You can also adjust what is displayed on a test result directly via the library:

result.log()

View test result metadata

After you have added a test result to your document, you can view the following information attached to the result:

  • History of values for the result
  • What users wrote those results
  • Relevant inputs associated with the result
  1. In the left sidebar, click Inventory.

  2. Select a model by clicking on it or find your model by applying a filter or searching for it.8

  3. In the left sidebar that appears for your model, click Documentation, Validation Report, or Ongoing Monitoring.

  4. Locate the test result whose metadata you want to view.

  5. Hover over the test result until the top-right hand corner menu appears and select See Timeline:

    • The Active (most recent) test result is highlighted.
    • On the test result timeline, click on the associated with a test run to expand for details, such as Model Information or Dataset Information.

    When you are done, you can either click Cancel or to close the metadata menu.

Filter historical test results

By default, test result metadata are sorted by date run in descending order. The latest result is automatically indicated as Active.

To narrow down test runs, you can apply some filters:

  1. On the detail expansion for test result metadata, click Filter.

  2. On the Select Your Filters dialog that opens, enter your filtering criteria for:

    • Date range
    • Model
    • Dataset
    • Run by
  3. Click Apply Filters.

Filters can be removed from the list of test result metadata by clicking on the next to them.

What’s next