Test Management for Jira plugin
The Test Management for Jira plugin provides Jira users test coverage and status information directly on native Jira epics, stories, issues, or custom types.
In this topic:
- Overview
- Installation
- Configuration
- Test Coverage widget
- Data Security and Privacy Statement (On-Premises)
Overview
The Test Management for Jira plugin allows Jira users to continue planning and working in Jira, with immediate visibility into the quality processes being managed in OpenText Software Delivery Management. This plugin helps Jira users understand test coverage and pass/fail status, while providing QA with full visibility and alignment to the development process being managed in Jira.
For details on supported versions, see Support Matrix.
Note: For details on the plugin REST API, see Test Management for Jira plugin API.
Benefits of the plugin and Connect
The Test Management for Jira plugin helps Jira users establish visibility into the quality process being managed in OpenText Software Delivery Management. For example, you can see the test coverage of a user story in Jira.
With Connect you can synchronize entities and issue types between OpenText Software Delivery Management and Jira, including releases, sprints, and backlog items, but not including tests. For details, see Use-case: Syncing OpenText Software Delivery Management and Jira.
If you use both Connect and the Test Management for Jira plugin, backlog items are synced to Jira using Connect. For those backlog items you see test coverage in Jira using the plugin.
The plugin works based on a user-defined field that is created in OpenText Software Delivery Management that contains the Jira issue type key. This way the plugin knows where to put the test coverage details. Using Connect can make this easier by populating the OpenText Software Delivery Management UDF with Jira key values.
Installation
This section describes how to install the plugin.
Jira On-Premises
You can install the plugin from within Jira as described in Installation.
Alternatively, you can download the plugin as a .jar file from Atlassian Marketplace or AppDelivery Marketplace, and install it as follows:
-
Log into your Jira instance as admin.
-
From the Admin dropdown, choose Add-ons.
The Manage add-ons screen appears.
-
Click Manage add-ons.
-
Click Upload add-on, and go to the location of the downloaded .jar file.
Configuration
You can configure multiple OpenText Software Delivery Management spaces, and multiple workspaces in each space.
-
Create a UDF of type string containing the Jira issue key. Add this to your OpenText Software Delivery Management features, user stories, defects, application modules, and requirement documents.
You can do this when you synchronize Jira with OpenText Software Delivery Management, or without synchronization. For example, if you have a user story in OpenText Software Delivery Management to cover the quality of a user story in Jira, you can create a UDF and manually enter its Jira issue key.
-
In the plugin configuration screen > Spaces area (Shared Spaces in the Cloud version), click Create.
-
Enter a name for the space, the OpenText Software Delivery Management URL, and the client ID and client secret used to access the space. For details, see API access.
Note: When configuring for Jira Cloud, the URL should point to an OpenText Software Delivery Management SaaS (HTTPS) location.
-
In the plugin configuration screen > Workspaces area, click Create.
-
Create one or more workspace configurations as follows:
-
Select a space from the list of spaces you defined, using the space name.
-
Select a workspace.
If you are using the Jira on-premises plugin, you can select multiple workspaces.
-
Enter the OpenText Software Delivery Management UDF in the Mapping field area (for example, jira_key_udf).
Suggestions for relevant UDFs based on the workspace you selected are provided. These are the fields that include jira in their name.
If you selected multiple workspaces in Jira on-premises, the Mapping field suggestions list the intersection of the relevant UDFs, meaning those that appear in all of the selected workspaces.
-
The Entity types field is automatically populated with the OpenText Software Delivery Management entities that have this UDF defined, to help you verify that you entered the correct Mapping field.
If you selected multiple workspaces in Jira on-premises, this shows the intersection of all the selected workspaces.
-
Select one or more Jira projects and Jira issue types where you want to see quality from OpenText Software Delivery Management.
Note: If you experience connection problems when installing a Jira on-premises environment, add a proxy.
-
Test Coverage widget
After setting up the plugin, the OpenText Software Delivery Management Test Coverage widget is added to issue details. The widget shows the number of tests related to the entity, and the summary of the last runs of these tests.
Use the dropdown to select an OpenText Software Delivery Management workspace. The entity mapped to the current Jira issue appears.
Each test can be run using more than one configuration, for example using different browsers. The widget shows a summary of the last run status of all the configurations. As a result, an entity might have (for example) 1 test and 3 test runs, since each run reflects a different configuration.
You can drill from the widget to the entity in OpenText Software Delivery Management, and to its related test details.
Data Security and Privacy Statement (On-Premises)
The Test Management for Jira plugin does not exfiltrate any of your data from the machine that hosts Jira.
The only information that the plugin stores is the configuration details listed in the Configuration section above, that specify which OpenText Software Delivery Management space you are mapping to which Jira project. This is stored in the database management system that you have configured Jira to use.
Privacy
The OpenText Software Delivery Management – Test Management for Jira plugin does not store any personally identifiable information in our databases.
OpenText encourages the customer to ensure secure connection between the plugin and the OpenText Software Delivery Management server by configuring communication over HTTPS, which is not provided by OpenText. By not implementing communication over HTTPS you may be exposing the system to increased security risks. You understand and agree to assume all associated risks and hold OpenText harmless for the same. It remains at all times the Customer’s sole responsibility to assess its own regulatory and business requirements. OpenText does not represent or warrant that its products comply with any specific legal or regulatory standards applicable to Customer in conducting Customer's business.
See also: