Introduction

The Jira Issues widget artifact adds two widgets that show issues from the connected Jira system. Both widgets are pie charts that organize issues by status or by priority. One widget has settings for querying Jira. The other widget allows you to manually enter a JQL to find issues. This artifact is shipped with the Parasoft Traceability Pack.

Requirements

By default, the search API for Jira will return a maximum of up to 1000 issues. This is an intentional limitation set by Atlassian to avoid any possible OutOfMemory exceptions. See the following Jira documentation for information on changing this limit:

https://confluence.atlassian.com/jirakb/exporting-a-filter-result-containing-more-than-1000-issues-191500982.html

Installation

Deploying the Widgets

After installing the Traceability Pack, you can use Extension Designer to deploy the artifact to a service, which will add the widgets to your DTP environment. The following instructions also appear in the Downloading and Installing Artifacts section.

  1. Open Extension Designer and click on the Services tab.
  2. Choose an existing service to deploy the artifact or create a new service in the DTP Workflows category. Refer to Working with Services for additional information on organizing services and artifacts.
  3. If you are adding the artifact to an existing service, add a new Flow tab (see Working with Flows) and choose Import from the ellipses menu.
  4. Choose Local > Flows > Workflows > Traceability Pack > JIRA Issues Widget and click Import.
  5. Click anywhere in the open area to drop the artifact into the service. 
  6. Double-click the Set JIRA URL node and specify the location of you Jira server.

  7. Double-click the Get JIRA Projects node and click the edit (pencil) icon for the Jira REST API Configuration field.

  8. Enter your Jira credentials and click Update. The user credentials must have access to all projects. Users will be able to add the widget to their dashboard and specify JQL, but the queries will fail without access to the project(s). 

    If Jira detects that a user is making requests from multiple machines, it may lock the user out. We recommend creating a dedicated user for Extension Designer to avoid being locked out by Jira.   

  9. Click Deploy.

Adding and Configuring the Widgets

After deploying the artifact, you can add Jira Issues widgets to a dashboard. See Adding Widgets for more information about this process. Jira Issues widgets can be found in the Jira category.

You can configure the following settings for the Jira Issues - Pie widget:

TitleEnter a new title to replace the default title that appears on the dashboard.
JIRA ProjectChoose a project from the menu.
ComponentChoose a component of the project from the menu.
Issue TypeChoose an issue type from the menu.
FieldChoose Status or Priority from the menu.

You can configure the following settings for the Jira Issues with JQL - Pie widget:

TitleEnter a new title to replace the default title that appears on the dashboard.
JQLSpecify your custom query. See the Jira documentation for instructions on creating JQL strings.
FieldChoose Status or Priority from the menu.

Using the Widgets

You can add multiple instances of the widget to create several views of the data stored in Jira.

Click on the widget to view the issue in Jira.