User Guide
As for any Mantis BT plugin:
- Download and unzip the plugin archive under /plugins folder
- In MantisBT go to page Manage > Manage Plugins and click the Install link for the "Traceability" Plugin as shown below:
Once installed, you can click the Traceability link to open the plugin configuration page as shown below:
The plugin configuration page allows you to select:
- the status thresholds to warn about undefined requirement and undefined test in the analysis page of the plugin
- the custom fields for Requirement identifier and Test identifier
- the identifier delimiter to support identifier list in the selected custom fields
- the management threshold required to configure the status thresholds used in the analysis page of the plugin
If no custom fields are configured in Mantis BT, the plugin configuration page displays by default the message "No string custom field found" as shown below:
To create new custom fields in Mantis BT, go to page Manage > Manage Custom Fields and click the New Custom Field button after indicating the name of this new custom field. Once clicked, a new configuration page is opened as shown below:
Two points of attention about custom fields configuration:
- Please verify that each custom field is associated to the projects where you want to use the plugin.
- Please verify that each custom field is displayed at the right issue state. Otherwise you won't be able to change their values and/or see their value on the plugin pages.
Once you created some custom fields in MantisBT, we are able to select them in the plugin configuration page as shown below:
You can edit the custom fields value for requirement / test identifiers from the view issue details as shown below:
Go to Traceability > Analysis to get the analysis result available for your projects as shown below:
Two points of attention about traceability analysis:
- Please verify the project filter settings in order to view the correct analysis results
- Please verify that the project you want to analyse as a correct roadmap (under Roadmap menu) Otherwise you won't be able to see any analysis results.
Go to Traceability > To Requirements to get the requirements traceability matrix as shown below:
You could filter the traceability matrix by project, product version, issue identifier, issue handler, and requirement identifier.
Three points of attention about requirements traceability matrix:
- Please verify the project filter settings in order to view the correct traceability matrix
- Please verify the filter you applied to the matrix
- Please verify that the project you want to analyse as a correct roadmap (under Roadmap menu) Otherwise you won't be able to see any traceability matrix.
Go to Traceability > To Tests to get the tests traceability matrix as shown below:
You could filter the traceability matrix by project, product version, issue identifier, issue handler, and test identifier.
Three points of attention about tests traceability matrix:
- Please verify the project filter settings in order to view the correct traceability matrix
- Please verify the filter you applied to the matrix
- Please verify that the project you want to analyse as a correct roadmap (under Roadmap menu) Otherwise you won't be able to see any traceability matrix.