How do I re-sync data from Jira?

The Jira Integration: qTest Enterprise is designed to work in real-time so that any changes from Jira are reflected in qTest immediately. However, sometimes the connection between the two tools can break, and the data can become out of sync.

For information on the permissions needed for qTest and Jira integration, refer to Which Jira Permissions Are Required to Set Up a Connection?.

Validate the Jira Connection

  1. Within your qTest project, select the Integration Settings option from the Project Settings list.

  2. In the Configure integration: Jira page, select the hyperlink of your Jira Connection Name.

  3. In the Jira Connection dialog, select Test Jira Connection. You should see a message: "Connected to server successfully." Then, select Save.

  4. You will be directed to the Jira Configuration page.

Re-sync your projects

Once you've verified that your projects are connected to Jira, you're ready to re-sync.

You have the option to re-sync all your projects at once or re-sync each project individually.

Re-sync multiple projects

If you have multiple projects to sync, you can use a single button in Configurations to re-sync the defects, requirements, and releases from all of your projects.

To re-sync all of your projects at once, follow these insructions:

  1. Navigate to Administration and select the Configurations tab.

  2. In the External Systems section, select Sync Jira Connections.

For best results, avoid syncing again for 24 hours, as re-syncing multiple projects can take a varying amount of time.

Re-sync individual projects

To re-sync an individual project, you need to separately sync your requirements and your defects.

Re-sync Jira Requirements

  1. If you have Requirements integrated with Jira, make sure to select the Retrieve Jira Data icon in the Requirements Integration section.

  2. You will see a progress bar indicating that Requirements from Jira are being synced.

  3. Once the retrieval is completed, you will see a confirmation message with the total number of requirements retrieved from Jira.

Re-sync Jira Defects

  1. If you have enabled Unlinked Jira Defects to bring in Jira Defects into Insights for reporting, then you will need to re-sync Jira Defect data. You can see if your qTest project has this enabled by looking for the check box selection in the Add ad-hoc Jira Defects to Insights Reporting section toward the bottom of the Defect Integration section.

  2. If you have Unlinked Jira Defects enabled, select the Fetch Jira Defect icon. You will see a progress bar indicating that Defects are being retrieved in the background.

  3. You can continue to work within your qTest project while this data is being retrieved.

Once your Requirements and Defects from Jira are re-synced Jira, you can continue working as before knowing that qTest and Jira are passing data in real-time as expected.