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 .


image
image
image

Click Jira Settings
Enter Jira Cloud URL
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


image

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.


image

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


image

In the resulting popup click Ok.


image

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


image

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

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.


image

    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

    8.Click Close to close the popup.
    9.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. 


image

    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.


image

In the resulting popup click Create Issue in Jira.


image

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


image

Click Save Result.


image

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. 

image

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. 

image


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

image

    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.

image


    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. 


    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.

image

    2.Click Add Issue – Click Add Jira Cloud Issue.

image

    3.Enter the details in Add Jira Cloud Issue and click save.

image

image

    4.The issue is posted in your mapped Jira Cloud project now.
    5.After saving the issue click View icon or click view more to see the linked Jira tickets.
    6.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. 


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.


image


    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.


image

  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.

image


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


image

         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.