Widget descriptions

The dashboard provides a variety of customizable widgets to assess the development progress and quality.

For descriptions of VSM widgets, see Value Stream Management widgets.

In this topic:

Quality analysis widgets

You can check the quality of the application development.

In the Dashboard module, add the following widgets to assess the quality.

Widget	Details
Feature coverage	This widget enables you to see the number of tests covering a feature that did not yet run, and the status of the feature's tests that already ran.
Feature quality status	This widget enables you to see how much testing has been completed on your features. You can also analyze the quality of the features by reviewing the number of runs according to status.
Open defects by feature	This widget enables you to see the outstanding defects for each feature and their severity. It helps you understand their current quality.
Features by risky commits	This widget enables you to recommend further regression testing before finishing the release.
Quality by application module	This widget enables you to see the quality of each area of the application. You can configure the Criteria to use to determine the level of quality. For example, you can use the number of defects, percentage of failed tests, or percentage of risky commits.

Scripted widgets

You can add custom widgets created by your administrators to your dashboard. These widgets allow for custom visualizations and logic not available in standard widgets.

External widgets appear in the widget gallery, either under a specific category defined by the author or under All.

Traceability widgets

The Traceability widget reflects relationships between a selected primary entity and a secondary entity. You can set filters both on the primary and the secondary elements.

For example, you can use traceability widgets to see the following:

• All the requirements of a particular release, and all the tests that cover them.

• All of your team’s features and the defects that cover them.

• Requirements that are traced to/from a set of requirements.

To see requirements or features that do not have test coverage, use the filter to only include those without a relation.

Release forecast widget

To view your release's trajectory, add the Release forecast widget to the Dashboard module.

This widget displays a line with the trajectory of user stories or defects through the end of the selected release. This widget also includes details on the release, including finished story points and expected completion.

The Done Story Points line shows actual progress, and the Expected Velocity line shows expected velocity as defined by the team leader or equivalent role.

The Forecast line (dotted) is displayed after you mark enough Backlog items as Done.

• Indicates that the release content is expected to be done by the release date.

• Indicates that the content is not expected to be complete on time, at the current rate of progress.

Forecast calculation

• The forecast is based on the state of the release’s actual story points until now, together with the planned story points for the team. This is based on the team manager’s expected velocity, as defined in the Team Backlog module. The gap between actual and planned velocity is used to forecast when the release content is complete, based on the assumption that this gap remains constant in the future.

  For example, if the expectation to date is 50 points and actual completion is 45, the gap shows that the current pace is 90%. The forecast assumes that at the planned date of completion, 90% of the content is done.

• If there is no expected velocity available for calculation, the forecast is based on the assumption that the actual points-per-day rate remains constant in the future.

Forecast widgets

Forecasting is available in Agile widgets, but not in Custom widgets. Forecasting is available for a release, and not for a sprint. You can see forecast data in burn-up widgets only.

If there are too few story points to generate a release forecast, your widget is empty. Clear the Forecast checkbox to show data in the widget.

Feature cycle time widgets

Several widgets are provided to help you track the cycle time for your features and other work items, such as user stories and quality stories, in a specific scope.

For details on calculating the average cycle time, see Cycle time.

Feature cycle time by phase across releases widget

The Feature cycle time by phase across releases widget is a trend widget that shows how long features remained in each phase across multiple releases.

The feature average phase time across releases is calculated as follows:

The y-axis shows the average number of days that the features remained in each phase. In the Scope page, you can indicate which phases and releases to track.

Study this widget to find patterns in the feature cycle time. This information lets you spot anomalies in the release cycle and pinpoint the problematic phases. When you hover over the different sections of the widget, the tooltips show a summary of the time periods. For example:

In this example, the later release shows a decrease for the In Progress phase, but an increase for the Ready for QA phase for Release 2. In the second release, the time that features waited for QA is higher, which may indicate a shortage in QA resources.

Feature cycle time by phase widget

The Feature cycle time by phase widget is a summary widget that shows how long features remained in each phase.

The feature average phase time is calculated as follows:

The y-axis shows the average number of days that the features remained in each phase. In the Scope page, you can indicate which phases and releases to track.

This widget enables you to select features completed on a specific time frame (not necessary coupled to a specific release). It also enables you to drill down to the phase time of each item in order to identify bottlenecks.

Defect resolution time widgets

Several widgets help you track defect resolution time. These widgets also have insight cards that provide you with tips and suggestions on how to interpret and act on the widget's information. An additional insight allows you to determine the quality of defect resolution, by displaying a graph of defect resolution time versus reopen rate. The Reopens field displays the number of reopens for each defect. If it is not displayed, use the Customize fields button to add it. For details, see Insight cards.

For details on calculating defects resolution time, see Cycle time.

Defect resolution time by phase across releases

This trend widget shows how long defects remained in each phase across multiple releases. The y-axis shows the number of days that the defects remained in each phase. In the Scope page, you can indicate which phases and releases to track.

Study this widget to find anomalies in the defect resolution time. This information lets you spot issues in the release cycle and pinpoint the problematic phases.

In the following example, although a reduction in the resolution time occurred for Release 2, there was an increase for Release 4. specifically in the Pending Support phase. This indicates that the handling of this defect by support was a bottleneck in the development cycle.

When you hover over points in the widget, information about how long the defects remained in each phase, at the selected point, is provided.

Defect resolution time by phase

This summary widget displays how long defects remained in each phase. The y-axis shows the number of days that the defects remained in each phase. In the Scope page, you can indicate which phases to track.

In the following example, it is evident that the defects remained in the Rejected phase for longer times than any other stage.

Test runs burn-down widget

The Test runs burn-down widget shows the execution of your planned runs over time, enabling you to track the convergence of your test run plan.

The widget helps you understand if testing will be finished by the release deadline, or if you need to increase testing resources in case the burn-down is not following the expected test run over time.

In the widget's Display tab in the configuration area, you can specify an Expected start point value. This metric is a simple baseline starting from a selected point and reaching zero at the end date. If you do not provide a value for the expected start point, the graph will use the number of planned runs at the widget's start date. For details, see Add and configure widgets.

Expert users widget

The Expert users widget is available from the Overview tab of the Quality module. The widget lists users who are most active on a specific application module.

The users are rated with stars that reflect the user expertise. The level of a user's expertise is relative to other users' expertise, and is based on the following metrics.

Metrics	Details
Item score	The item score is calculated to measure user expertise for the item owners. The item score is based on the following metrics: Story points: The number of story points for a work item. Item type constant: Each item type has its own constant score. For example, the score for user stories is four points, and the score for defects is two points. Degradation factor: The correlation value used to assign old work items with less weight (number of story points). For example, work items completed more than four months ago get half the weight of new work items of the same type. The item score is calculated as follows: item score = (item story points + item type constant) x degradation factor
Expert score	Once the item score is calculated using the above formula, the scores for items owned by a user are summed up. The scores are then normalized to a scale of 0 to 100, in order to facilitate the representation. The item scores are then compared, per user: The user with the lowest item score is assigned an expert score of 0. The user with the highest item score is assigned an expert score of 100. Other users are assigned an expert score ranging from 0 and 100 according to their expertise relative to the users with the lowest and the highest scores.

Based on the expert scores, the user is rated with stars:

• 3 stars: The user has an expert score exceeding 75.
• 2 stars: The user has an expert score exceeding 60.
• 1 star: The user has an expert score exceeding 20.

Single number (KPI) widget

You can configure a custom summary widget to display critical KPIs, such as critical defects, feature story points, or waste time, as a single number.

Configure the widget as follows.

Fields	Values
Scope	Configure the scope to display the number for an item type in a release and milestone. Apply additional filters, as necessary.
Display	Configure the following display options: Display type: Number chart. Function: Indicates whether the widget number should reflect a count, sum, or an average. For a sum or average, you need to select a unit relevant for the selected item type, for example Estimated hours, Invested hours. The x-axis function is not available for the Number chart display type. Show change indicator: Indicates whether the value increased or decreased compared to an earlier time period. After you enable this option, you specify a Comparison period. The comparison period should have the same date format specified in the Data tab's filter. Compare with the previous range: Select is to compare with the Previous range, the range preceding the one specified in the filter. For example, if the you select Last 30 days, the previous range will be 60 days prior. Previous range is supported for the following presets: last {x} days, between, and today. Compare with a specific range: Select is between to specify a custom time range for the comparison. Direction: Indicates whether an increase in the number indicates an improvement, Higher is better (default) or a decline in performance, Lower is better. Use conditional color ranges: Sets a threshold for displaying the widget number in custom colors. The following example shows a widget configured to display the number of critical defects, with colors applied to mark defect ranges 0-14, 15-24, and 25 and above: The colors are configurable. Click the colored circle to choose a different color for a number range.

Create a custom cycle time widget

You can create a custom cycle time widget to track the average cycle time for features, stories, or issues across releases. This widget helps you measure workflow efficiency and identify bottlenecks.

To create a custom cycle time widget:

1. Click + Add widget to open the Widget Gallery
2. Click + Add custom widget.
3. In the General tab, select Current Status and enter a graph name, for example Feature average cycle time across releases.
4. In the Data tab:
   1. Set Item Type to Features, User Stories or Issues.
   2. Select whether to use a Local or Global filter, depending on how you want the widget to inherit dashboard filters.
   3. Set the date field to Done date.
   4. In Additional filters, add a filter where Metaphase - is - Done so that only completed items are included.
   5. Optionally, use the Release, Target Sprint, or Milestone fields to further scope the data.
5. In the Display tab:
   1. Select a column chart display.
   2. Set the Y Axis function to Average, the item type to Features, and the measure to Cycle time.
   3. Set the X Axis to Release.
6. Click Save to add the widget to your dashboard.

See also

• Dashboard
• Insight cards
• Root cause analysis widget
• Track release progress
• Application module quality