Skip to main content

Filtering the Traceability Matrix by Build

The Requirements Traceability Matrix now includes a Build filter, allowing you to view requirement coverage and test results for a specific software build.

The Build Filter

At the top of the Requirements Traceability Matrix page, you'll see a new dropdown labeled Build: (visible only when Builds are enabled).

Using the Filter

  1. Click the Build dropdown to see all available builds in your project

  2. Builds are shown with their version and environment, e.g., "v2.14.1 - Production"

  3. Select a build to filter the matrix for that build

  4. Leave it blank (or click the X to clear) to view the global view with no build filter

When you select a build, a blue chip appears showing "Coverage as of v2.14.1" (or whatever build you selected).

Build selector on requirements traceability matrix in TestCollab

What Changes in the Matrix When a Build is Selected

Without a Build Filter (Global View)

The matrix shows the latest status of each requirement based on all test executions ever run against it, regardless of which build was being tested.

With a Build Filter (Build-Scoped View)

The matrix shows the status of each requirement based only on test executions that ran against the selected build.

Example

Requirement: "User can login with email"

Global view: Passed (because the most recent execution passed)

Build-scoped to v2.14.0: Passed (the plan linked to v2.14.0 ran and passed)

Build-scoped to v2.14.1: Not executed (the plan linked to v2.14.1 hasn't been run yet)

This is powerful for checking: "Did we test all our requirements against Release 2.14?"

Exporting Build-Scoped Coverage

When you export the Requirements Traceability Matrix as CSV (using the Export button), the exported file includes:

  • All the standard RTM columns (requirements, test cases, status)

  • An extra Build column showing which build the coverage is scoped to

  • A build-stamped filename, e.g., rtm-export-v2.14.1.csv

This provides an auditable artifact showing exactly which requirements were covered against a specific software version.

How to Export

  1. Select a build using the Build filter

  2. Click the Export button

  3. The CSV file downloads with the build version in the filename and an extra Build column in the data

Example filename: rtm-export-v2.14.1.csv Example row: Requirement: Login, Test Case: Test_Login, Status: Passed, Build: v2.14.1

Related Articles

Did this answer your question?