Versions Compared

Key

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

Table of Contents
maxLevel4

Pre-requisites: Supported QMetry Jira Integration

Below is the support matrix for the QMetry Test Management Jira integration app.

...

Note : If you are using a Cloud Jira or Server Jira and integrating with QMetry Cloud instance then the Jira instance should be accessible to QMetry instance, refer to the link - QMetry IP Address to Whitelist.

Step 1

...

. Install App: "QMetry Jira Integration"

Install "QMetry Jira Integration" app in your Jira Instance. It is free to download.

...

4. Click on the Get it now button.



Step 2

...

. Configuring Jira app with QMetry Admin


1. After installing the "QMetry Jira Integration" app follow below steps to configure Jira with QMetry. The integration requires QMetry admin credentials. 

...

B. Connect using Open API Key: If you have an integration package enabled then only you will get the Open API key. You can use the Open API key for any user to connect QMetry with Jira.

A. Connect Using Credentials

Note:

  • Integrate with QMetry users using QMetry authentication. A QMetry user authenticated with SSO login can not be used for Integration. Recommended - Use the system admin (for cloud instances - the user who has registered for the QMetry instance) or administrator (for server customer - user "Admin" is the administrator) user for authentication.
  • If the user has Two-step Verification enabled in QMetry, then they need to provide the Two-step Verification code to connect using this method. Users with Two-step Verification disabled can connect directly by providing credentials and Organization Code.

(1)  Go to Jira settings  >> (2) QMetry Configuration >> (3) Enter QMetry URL (4) Enter QMetry Admin Credentials and Organization Code >> (5) Connect the configuration.

...

4. On submitting the valid Two-step Verification code, the Jira integration is established with QMetry.



B. Connect Using Open API Key

Users can also integrate Jira with QMetry by using the Open API Key of QMetry (Integration > Open API).

Note: Open API Key is only available for users who have opted for the Integration app.


Image Modified


After entering the valid Open API Key and clicking Connect, the Jira integration is established with QMetry.


Image Modified


If you are using Cloud version of Jira, the integration app "QMetry Jira Integration" will be displayed as follows in Jira under the Apps > Manage apps section.



If you are on Server or Data Center version of Jira, the integration app "QMetry Jira Integration" will be displayed as follows in Jira under the Apps > Manage apps section.


Step 3

...

. Verify All Modules are Enabled (only for server or data center Jira editions).

Note: Skip this step if you're using Cloud Jira.

If you are on Server or Data Center version of Jira, then verify that all the modules are enabled on the Manage app screen.

  1. In Jira, go to Apps > Manage apps section.
  2. Expand the modules section and make sure that all the modules are enabled.


Step 4: Verify the QMetry - Jira Integration is Active

After the successful configuration with the above steps, QMetry "Integration" section will start showing "JIRA" configured as below.

...

The Associated QMetry Projects column will show QMetry projects configured with this integration.



Sync fields to Reports

Note: The feature is only available to the customers who have opted for the Advanced Reports App.

...

2. Turn the Sync fields to Reports option “On” for the integration to sync mapped external custom fields to QMetry Insights. By default, the option remains “Off”.




Step 5: Integrate Jira Project with A QMetry Project

Refer to this link to Map Jira Projects with QMetry Projects.

Step 6: Enable QMetry Test case and BDD panels for Jira Projects

Configuration to enable QMetry Test case and BDD panels for Jira Projects. This change is required for all Jira projects that are to be integrated with QMetry.

1. Log into Jira and open your Project. Click on Project Settings on the sidebar.

           Image Modified

2. Locate and go to QMetry Features on the sidebar.


Image Modified

           

3. Click on QMetry Features to open the QMetry Configuration screen.


Enable QMetry Panels for Project: Enable it to make the QMetry Test Case panel visible on issue screen. If the feature is disabled, the QMetry panel will not be displayed on Issue screen. This panel shows the Test cases - Issue linkages.


Image Modified


Issue Type - Enable Issue types for which Test case and BDD panel should be displayed in Jira.

Image Modified

BDD and Test Case panels are enabled only for the current project (and not all other projects having the same project type).

...