Traceability
Work Item Traceability
On the work Item page there is a Traceability section which is always closed by default. After expanding this section, the downstream and the upstream traceability of the single work item is displayed in 2 levels by default. If you modify one of the options in the traceability section, the entire traceability sections reloads automatically. The following options can be used to modify the traceability section table:
• Show associations: Select to show the related Associations (not just References), This option is selected by default.
• Number of levels: Select the required number of levels in the number of levels list. The maximum number is up to 10 levels.
• Show description: Select to view the descriptions of the items. This options is not selected by default.
• Show SCM commits: Select to view the SCM commits as items. This option is not selected by default.
• Do not show redundant Items: Select to hide the redundant items inside the traceability section. The default value for this section is configurable in the traceability section under Application Configuration.
Global Configuration
To avoid performance issues, System Admins are able to configure some limitations using the traceability tag in the traceability section. These are the default values:
"traceability": {
"maxFirstLevelElements": "25000",
"maxAdditionalLevelElements": "25000",
"maxFirstLevelElementsPerItem": "500",
"maxAdditionalLevelElementsPerItem": "200",
"pageSize": "50",
"ignoreRedundantsInBrowser": "true",
"ignoreRedundantsInTab": "true" }
Attributes:
• maxFirstLevelElements Maximum number of Tracker Items in Level 1
• maxAdditionalLevelElements Maximum number of Tracker Items in the other levels (Level 2 and deeper)
• maxFirstLevelElementsPerItem Maximum number of Tracker Items per previous Item in Level 1
• maxAdditionalLevelElementsPerItem Maximum number of Tracker Items per previous Item the other Levels (Level 2 and deeper)
• maxTestRunItemsPerItem Maximum number of Test run items per previous item. (Level 1 and deeper)
• pageSize Default page size, number of Tracker Items of the Initial Level will be loaded first, the other elements will be loaded by incremental scroll
• ignoreRedundantsInBrowser True or false, if the Traceability Browser should ignore redundant nodes.
• ignoreRedundantsInTab True or false, if the Work Item page Traceability Tab should ignore redundant nodes.
• maxNumberOfLevels - The maximum number of reference levels displayed. For further information on this parameter, see the traceability section on page Application Configuration
 |
It is possible to add any number of reference levels, however, if too many levels are configured, managing your view may become difficult.
|
The limitation options have maximum values. In case the provided value is higher than the maximum value, then the maximum value will be used:
• maxFirstLevelElements = 100000
• maxAdditionalLevelElements = 100000
• maxFirstLevelElementsPerItem = 500
• maxAdditionalLevelElementsPerItem = 200
• maxTestRunItemsPerItem = 100
• pageSize = 250
• maxNumberOfLevels = 5
The Traceability Browser Wiki plugin will use the set number of maxFirstLevelElements in the Initial Level too.
If you reach one of the limitations, a warning icon will appear in the proper place of the result table, to show that there are other elements which are not displayed because of the limitation.
Example application configurations settings:
"traceability" : {
"ignoreRedundantsInBrowser" : true,
"ignoreRedundantsInTab" : true,
"maxAdditionalLevelElements" : 25000,
"maxAdditionalLevelElementsPerItem" : 200,
"maxFirstLevelElements" : 25000,
"maxFirstLevelElementsPerItem" : 500,
"pageSize" : 50
"maxNumberOfLevels" : 5
},