Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

UI Steps
UI Step

How to use a Gadget?


A gadget allows you to display dynamic content inside a dashboard, these gadgets can be as simple as lists based on filters, or complex reports. 

You can add gadgets to your personal dashboard, and even share dashboards with other users. By doing this, you are personalizing your own view of information and build a way to get insights that will help you to make better decisions. 


To use a gadget:

  1. Go to the dashboard by selecting the Dashboards link in the header.
  2. If you don't already have a dashboard, select Manage Dashboards from the dropdown, then Create new dashboard.
  3. Once your dashboard is created, on the dashboard, select Add Gadget.
  4. Use the gadget wizard to choose the gadgets you want to add.

Image RemovedImage Removed




Tip

After loading all the gadgets available, you can search for "xray" to easily find the gadgets made available by Xray.



UI Step

Gadgets available by Xray


Test Runs List Gadget
Gadget

Example

What to use for?Similar to Mode details
Overall Requirements Test Coverage Gadget

Image Removed

Quick way of evaluating the current coverage status for a set of requirements, that can span one or more projects. Overall Requirements Coverage Report
Historical Daily Requirements Coverage Gadget

Image Removed

Provide visibility into the evolution of the coverage status of your project's requirements for last N days, for a given version of the system.

Evaluate your progress, i.e., if you're closer to having all your requirements properly tested and ready for deployment.

Cloud Coverage Report
Test Runs Summary Gadget

Image Removed

Check status of a group of scheduled/executed test runs (e.g., from a Test Plan) in order to evaluate the testing effort.

N/A
Test List Gadget

Image Removed

Check the status of a group of tests for a specific Version, Environment or Test Plan. Test Overview

Image Added

Source requirement issues for the chart can be provided by using a saved filter or by selecting a project:

  • Project or Saved filter: a saved filter  or a project containing requirement issues.

Notice that "Project or Saved filter" must be select in order to use the gadget.

Overall Test Coverage
Tests List Gadget

Image Added

This gadget provides a quick way of evaluating the current status of your project tests. You're able to visually identify the tests by filtering them beforehand, and determine their status.

Xray makes it possible for you to analyze the status for a given version, taking into account the executions made for that version. Alternatively, it is possible to perform this analysis by considering a specific Test Plan; thus, you're able to evaluate the status in its context. 

Tests List Gadget
Test Sets List Gadget

Image Added

This gadget provides a quick way of evaluating the current status of your project test sets. You're able to visually identify the test sets by filtering them beforehand, and determine their overall status based on all the tests associated with them.

Xray makes it possible for you to analyze the status for a given version, taking into account the executions made for that version. Alternatively, it is possible to perform this analysis by considering a specific Test Plan; thus, you're able to evaluate the status in its context. 


Test Sets List Gadget
Test Execution List Gadget

Image Added

This gadget provides a quick way of evaluating the current status of your project test executions. You're able to visually identify the test executions by filtering them beforehand, and determine their overall status based on all the tests associated with them.


Test Execution List Gadget
Test Plans List Gadget


Image Added

This gadget provides a quick way of evaluating the current status of your project test plans. You're able to visually identify the test plans by filtering them beforehand, and determine their overall status based on all the tests associated with them.


Test Plans List Gadget
Overall Test Results Gadget

Image Added

This gadget provides a quick way enables of evaluating the status for some Tests, taking into account the results obtained in the context of a version or of a Test Plan.

Possible usage scenarios:

  • See the amount of Tests, by current status, for a specific Version or Test Plan (i.e. have an overview of the Tests in the context of a version or of a Test Plan)
  • Analyse the overall progress of a Test Plan
  • Analyse the overall status of some Tests, on some specific Test Environment
  • Analyse how a subset of some Test cases currently is (e.g. the ones defined by some relevant criteria in a user defined filter), in some version or in some Test Plan
Overall Test Results Gadget
Overall Test Results Gadget

Image Added

This gadget provides a quick way of viewing the the overall test types for a given project or filter.

Tests by Test Type Gadget
Requirement List Gadget

Image Added

This gadget provides a quick way of evaluating the current status of your project tests. You're able to visually identify the requirements by filtering them beforehand, and determine their coverage status.


Requirements List Gadget
Test Runs List Gadget

Image Added

This gadget enables you to see

Image Removed

Analyse

which Tests were or are going to be executed, along with their corresponding results.

N/A

Possible usage scenarios:

  • see all the runs of a given Test Execution
  • see all the runs of all Test Executions associated with a Version
  • see all the runs associated with a particular component
  • see the executions performed by or assigned to a specific user.
Test Runs List Gadget
Test Runs Summary Gadget

Image Added

Image Added

This gadget enables you to see the overall status of a group of scheduled/executed Test Runs

Tests Evolution Gadget

Image Removed

Discover the evolution/trend of the status of a group of Tests, taking into account the results of those Tests in certain Test Executions.

You can check the calculated status

(e.g.,

TODO, PASS, FAIL, etc.) of the Tests in a specific time range.
N/AOverall Test Results Gadget

Image Removed

from a Test Plan) through a vertical bar chart or a table, showing the amount of Test Runs per status, grouped by a given Test or Test Run field.

Some possible usage scenarios:

  • analyze the Test Runs from a Test Execution
  • analyze the Test Runs from all Test Executions belonging to a Test Plan
  • depict the testing results for a given component,
Get an overview of the status for some Tests, taking into account the results obtained
  • in the context of a
version
  • Test Execution or
of a
  • Test Plan
N/ARequirement List Gadget

Image Removed

  • see how the testing is progressing in terms of scheduled runs, from the Test Run assignee perspective
  • see how the testing is progressing in terms of scheduled runs, based on the Test priority
  • see how failures, or some other test run statuses, are impacting components
Test Runs Summary Gadget

Quickly check the status of a group of requirements for a specific Version, Environment or Test Plan.

N/A
UI Step

Setting a Gadget

After selecting the gadget you want to use, you may need to perform some settings, especially the source data ( Project or saved filter?). 

Other settings can be made depending on the gadget that you have selected such as:

  • date range 
  • group by 
  • Execution Scope


Tip

By using a saved filter means, that you can display information from across different projects. Be aware that you might have to create the filter first (using Jira built-in features) in order to use it at your gadget.


Check out the documentation about each gadget to see the settings you can perform at each gadget - Reporting using Gadgets.