/
Coverage View

CLOUD | DATA CENTER AND SERVER

Coverage View

Overview

The Coverage View provides an overview of project requirements or subsets of requirements from the point of view of completeness. The view helps answer questions such as how well high-level requirements can be traced to lower-level requirements, or other types of issues such as test cases. It helps identify gaps in coverage that may require attention.

The view displays a customizable chain of linked requirements or other issue types, organized into columns. This arrangement helps users assess the extent to which these requirements cover the entire domain. A completeness calculation aids in this assessment. For example, you can determine if customer-level features are appropriately broken down into technical requirements, and whether these are in turn covered by test cases.

To navigate to the coverage view, open an easeRequirements project and select Coverage in the easeRequirements menu bar.

The effective use of the coverage view depends on the practices of your organization and its development process. You need to take into account how different types of requirements or other types of issues are structured, as well as how they are linked together and used. An organization might have different practices for different situations, so different coverage views can be defined and saved in the Coverage View.

The sheer number of requirements in a project may also be a challenge to understanding the coverage, so identifying significant subsets of the requirements and organizing them in different views is also an effective practice.

User Interface

A coverage view is displayed as a table whose cells contain requirements or other types of issues. The columns, called “levels”, indicate relationships between the requirements. For example, the first column might contain high-level Customer Requirements, while the second column contains lower-level Functional Requirements, representing a relationship between the two sorts of requirements. The relationship is defined by links between the requirements.

By default, the relationship involves adjacent columns, but it is possible to have a relationship between non-adjacent columns. This is indicated with the option Column Basis in the coverage view configuration.

By inspecting the table, users can quickly identify gaps in coverage by the appearance of cells labeled “Not covered”. For example, a Customer Requirement that has no related Functional Requirement is easily spotted by that label appearing in an adjacent cell in the Functional Requirement level. Each level except for the first also displays a completeness percentage.

Saved Coverage Views

A panel on the left of the coverage view provides a list of saved views and context menu operations to manage the views. The views are organized into two folders:

  • Personal Views: These views are only available to the user that created them. By default, a newly created view is personal.

  • Public Views: These views are available to everyone who has access to the Jira project.

Coverage View Operations

Purpose

Operation

Comment

Purpose

Operation

Comment

Open saved coverage view

  • Select a save view.

 

Create new coverage view

  • Select New View from the left panel.

  • Configure the first column in the dialog:

    • Enter a label for the column.

    • Determine the source of the issues for the column using one of the options:

      • Issue types:

        • Projects: Select the desired projects.

        • Issue types: Select <any> for issues of any type or select one or more types.

      • Filter: Select an existing filter.

      • JQL: Enter a JQL query. The default value is the project JQL for the current project.

      • Cloud Tree: Select a Tree Folder.

    • Select Select.

  • Configure the second column in the dialog:

    • Select Add Coverage Level from the right panel.

    • Enter a label for the column.

    • Determine the source of the issues for the column using one of the options:

      • Issue types:

        • Projects: Select the desired projects.

        • Issue types: Select <any> for issues of any type or select one or more types.

      • Filter: Select an existing filter.

      • JQL: Enter a JQL query.

    • Determine the Link Descriptions to be used – see How to select link descriptions.

    • Select Add.

  • Optionally configure additional columns as above.

  • Select Save.

  • Enter a name for the view.

  • Select Save icon.

As of the third level, the option Column Basis becomes available, making it possible to select a different level as the anchor of the relationship rather than the level immediately to the left.

Update level configuration

  • Select the update icon in the header of the desired column.

  • Modify the level configuration in the dialog.

  • Select Update.

 

Add level

  • Select Add Coverage Level.

  • Enter a label for the column.

  • Determine the source of the issues for the column using one of the options:

    • Issue types:

      • Projects: Select the desired projects.

      • Issue types: Select <any> for issues of any type or select one or more types.

    • Filter: Select an existing filter.

    • JQL: Enter a JQL query.

  • Select Add.

As of the third level, the option Column Basis becomes available, making it possible to select a different level as the anchor of the relationship rather than the level immediately to the left.

Remove level

  • Select the remove icon in the header of the rightmost column.

Only the rightmost level can be removed.

Refresh coverage view

  • Select Refresh.

 

Create new coverage view from saved view

  • Select a saved view.

  • Modify the view configuration as desired.

  • Select Save As.

  • Enter a name for the new view.

  • Select Save icon.

 

Delete coverage view

  • Select Delete from the context menu of the saved view.

  • Select Delete.

 

Export coverage view to Excel

  • Select Export Excel from the context menu of the saved view.

  • Select the file name under which the Excel file should be saved.

Export is handled as a background task since the operation may take some time. It is possible to continue working while the task is executing. A save file dialog will appear when the task is complete.

While coverage completeness is being calculated, export is disabled.

Data Center Export coverage view to Excel using a template

  • Select Export Template… from the context menu of the saved view.

  • Select the file name under which the Excel file should be saved.

Copy coverage view link to clipboard

  • Select Copy Link Address from the context menu of the saved view.

 

Sort saved coverage views

  • Select Sort by name from the context menu of a saved views folders.

  • Select the option Ascending or Descending.

 

Change position of saved coverage view in list

  • Grab the desired view.

  • Drag and drop it in the desired position.

This is how to change a view from private to public or vice-versa. Only the owner of the view can do this.

CLOUD Enable column filter for uncovered issues

  • Select the filter icon in the header of the second or subsequent columns.

  • Select checkbox Not covered

  • Select a folder in the project tree.

  • Select Select.

This only shows issues in the other columns that are not covered by an issue in the column to which the filter is applied.

DATACENTER
Enable first column folder filter for issues part of selected tree parts

  • Select the filter icon in the header of the first column.

  • Select a project.

  • Select a folder in the project tree.

  • Select Select.

It obviously makes no sense to select a project that is not one of the projects used in the view.

Disable column filter

  • Select the filter icon in the header of the column.

  • Select Reset.

 

Link or unlink issues

  • Select “…” in an issue cell.

  • Select the desired action:

    • Create linked issue

    • Link existing issue

    • Remove issue link

  • Complete the ensuing dialog.

 

DATACENTER Review suspect link

  • Select the suspect icon in an issue link flagged as suspect.

 

Open issue

  • Select the issue key in a cell.

 

Display as graph

  • Select “…” in an issue cell.

  • Select Display as graph.

  • Modify Quick Filters with the link direction of the displayed linked issue as desired:

    • Inward

    • Bidirectional

    • Outward

  • Select Hide Options or Show Options to hide or show the Quick Filters section as desired.

  • Select the expand icon or collapse icon to show or hide the linked issue as desired.

 

Configure display fields

See Display Fields Configuration.

 

How to select link descriptions

In the configuration of the second and any further columns, you are able to restrict the issues in the column (call it B) to those that are linked to issues in the basis column (call it A) by specifying one or more link descriptions. You select a link description by viewing the issues in column B as the subject of the relationship and the issues in column A as the object, and then selecting the link description accordingly. For example, let’s suppose 1) column B issues are Specifications (S) and column A issues are Requirements (R) and 2) the link type is Specification with the outward description “specifies” and the inward description “is specified by”. Then you would select the outward link description “specifies”, because “S specifies R”.

Multiple link descriptions can be selected. Select “<any>” if you want no restrictions.

Formula for coverage completeness percentage

given a = number of rows in previous column b = number of issues not covered (a - b) / a * 100

Known issues