QA Touch Jira Cloud Integration Guide

QA Touch and JIRA Cloud configuration Setup

We are going to see the steps to integrate JIRA Cloud in detail as below.

  1. Login to QA Touch as an Administrator
  2. Click the Administration → Integration Settings.
  3. Click JIRA Settings a. Enter JIRA Cloud URL b. Enter Email

How To Generate JIRA API Key In JIRA?

Click Here

  1. Log in to "https://id.atlassian.com" as Jira Administrator.
  2. Click API tokens, then Create an API token.
  3. Use Copy to the clipboard, and paste the token to your QA touch Jira Settings – API token.
  4. Enter API token generated from your Jira Administrator account
  5. Click Update
  6. After saving the settings, we have to configure the Jira project and map the QA Touch project
  7. After successful settings configuration, the screen looks like the screenshot shared below

Next step is the critical one,

which will map QA Touch project and Jira Project.

It can be done by accessing left navigation menu projects → project name → Project Integration Mapping.

Refer to the below screenshots.

In the resulting page, search the Jira project and select and click Update.

In the resulting popup click Ok.

The below snapshot will be shown after configuration of Jira project.


image

image

image

Next, we are going to see how to map Jira Requirements and test cases.

Enable List Project Permission in Jira

Click on Permissions Menu in the sidebar

Check whether the Browse project permission is enabled for the user if not Give the permission


The below snapshots show the permission schemes in Jira and configure the same.

image

image

image

image

image

image

Re-Generate JIRA API Key

  1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click API tokens, then Create API token.
  3. Use Copy to clipboard, and paste the token to your script This configuration has to be done with the Jira's administrator mail id and the API key to avoid the Jira Project permissions.

image

Mapping Jira Requirements and Test Cases

There are multiple ways to mapping the Jira requirements and test cases.

1.Pull Jira Requirements and mapping the test cases

2.Mapping Jira Requirements while creating the test cases

3.Test case view - Fetch Jira Requirements.


Pull Jira Requirements and Mapping the Test Cases

When you wanted to add multiple Jira tickets(Epic, Story, Bugs, Tasks etc) to the test cases faster.

  1. After logged In QA Touch, access the project which is mapped with the Jira project.
  2. Click Requirements
  3. Click Jira Requirements button.
  4. By default, you will be able to see the Epics from your Jira project.
  5. You can select the other Jira ticket types from the Issue type filter.
  6. Select the Jira ticket id and click link test cases.
  7. In the resulting popup select the module or search by tags to get the test cases you want to map it.


image

  1. Click Close to close the popup.
  2. Click Save to complete the mapping.

Mapping Jira Requirements While Creating the Test Cases

When creating the test cases itself, if you have your Jira requirements ready, then you will be able to map it. After logged In QA Touch, access the project which is mapped with the Jira project. Click Test Cases - Add Test Case Select the module and fill up the other values. Click Jira Requirements and select the Jira ticket type and click Save.


image

Test Case view - Fetch Jira Requirements

After logged In QA Touch, access the project which is mapped with the Jira project. Click Test Cases - Click View icon. Click Fetch Jira Requirements. In the resulting popup, you can select and map the Jira Requirements.

After selecting the Jira ticket ids click save to complete the mapping. In the view page, you will be able to see the mapped Jira requirements.


image

Jira Requirements Traceability Matrix

When the QA Touch’s test cases and requirements are mapped, Jira Requirements Traceability Matrix will be generated automatically. The Jira RTM can be exported in .xlsx format. It will look like below:


image

Executing Test Run and Add Result into Jira

Go to the configured QA touch project’s test run, click Add Result.

In the resulting popup click Create Issue in Jira.

Select the issue type, and enter the details for summary, Description, Assignee, Priority and Click Add Jira Issue.

Click Save Result.

You can map your existing Jira tickets during the test execution, it is also possible to do that.


In the Add result page click Fetch Jira Keys.

The Jira tickets will be listed. You can select the Jira ticket ids and click Link Issues. There are options to search the Jira tickets by Jira ticket ids or Search.


by title too to make it faster.


Once the tickets are linked, in the resulting page click Save Result to complete it.

  1. In the test run, you will be able to see the Jira tickets posted or You will be able to see the linked in the test runs will be available.
  2. You can export these tickets, you can access the Jira ticket from the link View in Jira.
  3. You can get the latest status of the Jira tickets, by clicking on the Pull Jira Status button.

Whenever an issue status in JIRA linked with QA Touch gets updated, the result will be pulled and updated in QA Touch. These status updates can be viewed under the JIRA issues section in the Test Run details page.


Creating issue or linking test results with JIRA issues will save all the test result details like issue summary, issue description and attachments in JIRA and QA Touch.

image


Prerequisite for seeing the QA Touch test results, QA Touch Jira App must be installed. Refer the following link to install and setup.

click here

Next we are going to see how the created Jira ticket appears with QA Touch test results in Jira.

  1. In Jira access the newly created ticket created from QA Touch.
  2. The description and the details are appearing.
    Click the 3 dots and click QA Touch Test Results.


image

The test results will appear in the Jira as below.

image


We have introduced another way to post Jira tickets from QA Touch without creating a test run. Make sure you configure the Jira cloud API and other details before proceeding to this.

Add Jira Cloud Issues Without Test Run

You will be able to post issues from QA Touch to Jira Cloud directly without creating a test run after setting the Administration configuration steps. The project mapping steps are below:


1.Click the mapped project’s Issues menu link from the left navigation menu. 2.Click Add Issue – Click Add Jira Cloud Issue. 3.Enter the details in Add Jira Cloud Issue and click save.

  1. The issue is posted in your mapped Jira Cloud project now.
  2. After saving the issue click View icon or click view more to see the linked Jira tickets.
  3. The linked Jira tickets appear like in the below snapshot. By clicking View in Jira, you will be redirected and able to access your tickets in Jira.

image


Jira Cloud Summary Report

  1. You will be able to generate reports for the Jira tickets posted from QA Touch’s Test run or without test run. The steps are below:
  2. Click the mapped project’s Reports menu link from the left navigation menu.
  3. Click Integration Reports.
  4. Click Add Report.

Select All Issues option and click Save.

This is to generate the report which will fetch both the Jira tickets mapped with test run as well as not mapped in test runs.


Click Integration Reports. You can download the report in csv, .pdf formats. Also you can share the report in email.

image


The sample output with the All issues option will look like this.


When you select Include Issues Mapped with Test Run option, you can select the test runs and click save.


  1. Click Integration Reports. You can download the report in csv, .pdf formats. Also you can share the report in email.
  2. The sample report output with the option Include Issues Mapped with Test Run.

image

Now, you have learned to know how to set up QA Touch and Jira Cloud and how to leverage its complete capabilities.

QA Touch is Two way Integrated with JIRA.

The Integration is continuously and automatically synced up between QA Touch and JIRA, allowing to manage the Issues and requirements with Ease.

image

How to Sync JIRA Cloud Custom Fields in QA Touch?

JIRA Custom Fields

It is a paid feature

You can sync your JIRA Cloud Custom fields to QA Touch Please see the screenshot below

Navigation Link : Project Menu -> Project Integration Mapping -> Custom Fields Settings

image

We have listed all the JIRA Custom fields, you can select and enable the field with switch on.

Note : Only "String" , "Number" , "Array" , "Option" type of Custom Fields are supported

image

Enable image

Mapped JIRA Fields in the QA Touch Issue
Note : Every project need to mapped JIRA Custom fields - Mandatory

image image