JIRA Integration

Owned by Daniel (Deactivated)
Last updated: Jan 09, 2019 by Kevin Pham (Deactivated)
2 min read

In Zephyr 6.2 and any future release, the Zephyr Connector is no longer required.


Zephyr comes with a 2-way integration to an external JIRA defect system via remote integration and connector. Currently, JIRA versions 6.4+ to 7.x are supported, either On-Premise or Cloud. We will continue to support JIRA versions in accordance with Atlassian's JIRA life-cycle support. While all the issues and administration of that defect tracking system continue to remain in JIRA, Zephyr reads and writes issues and pulls up metrics from that JIRA installation via APIs in real-time. There is no synchronization needed.
 
With this 2-way integration, a user will be able to do the following:

  • File a new defect in Zephyr and it will show up in JIRA
  • File a new defect in JIRA and search for it in Zephyr
  • Search defects by various fields
  • Update an existing defect (add comments, add attachments, change status, assigned to, priority and component fields)
  • Update multiple defects at once

 
There are 2 steps to this process:
1. Connecting Zephyr to JIRA: this allows you to map projects between Zephyr and JIRA, let Zephyr users login, view, file, update and search JIRA issues from with Zephyr's UI.
2. /wiki/spaces/ZE6/pages/148275398: this allows Zephyr to fetch metrics data from JIRA

Connecting your Zephyr to JIRA

In the Administration application, navigate to the Defect Tracking tab and enter the following information:

 

When this option is chosen, the following JIRA URL is needed:
http://<your_jira_server>
 
Where <your_jira_server> includes the name/IP address and the port of the JIRA server. Please do not enter the URL that is used to access JIRA directly from your browser.
 
Also, a valid JIRA admin-level username/password that has access to all the projects being tracked is needed to fetch data for defect metrics. Each user in the Zephyr system will need their own JIRA username/password to File and Search for defects in their own Desktops.


IMPORTANT

  • Please note that you cannot switch to another Defect Tracking System at a later stage. You will be able to turn it off (i.e. by picking the "None" option)
  • To test if this is working, once you have entered this information and reloaded your application (logout and log back in again), go to the Project Setup application, select a project and click on the drop-down for "Map External Defect Project". It should show you a list of your JIRA projects


  • If you are using a Zephyr Enterprise SaaS/Cloud instance and you have a JIRA on-premise or server hosted on your end, please ensure that all the calls (outbound and inbound) between the Zephyr SaaS IP and your JIRA server are whitelisted. To ensure this is done correctly, please involve your network or system administrator for making any and all necessary changes to your network to provide you with a smooth integration of your JIRA instance with Zephyr.


Installing the Zephyr Connector

Read this section for /wiki/spaces/ZE6/pages/148275398.
 
Note: If you are using Atlassian Cloud, the Zephyr Connector plugin comes pre-installed.