Applies to QAComplete 12.31 SaaS & On-Premises, last modified on September 12, 2019

QAComplete seamlessly integrates with JIRA – the QAComplete Integration for JIRA plugin enables synchronization between JIRA issues and QAComplete defects and requirements.

Enable the synchronization

To synchronize items:

How it works

While the synchronization is enabled, when you update an item in one system, the corresponding item will be updated in another system automatically. The synchronization is real-time. Changes you made to an item in one system are copied to another system immediately.

During the initial setup, you can decide whether you want to synchronize the existing QAComplete and JIRA items created before the synchronization was enabled. It is also possible to synchronize the existing items at any time, on the JIRA plugin configuration screen in QAComplete:

QAComplete integration with JIRA: The Sync now button

Click the image to enlarge it.

When you add a comment (note) to an item, the comment (note) will be copied to the corresponding item in another system. The information on the comment’s (note’s) author will be copied as well. When you attach a file to an item in one system, the attachment will be automatically copied to the corresponding item in another system. When you update the attachment in one system, the corresponding attachment will be updated in another system (if the attachment names coincide).

All actions applied to synchronized items by you and other users are stored in QAComplete as log records.

In QAComplete, synchronized items have the Synced label in the Edit form and a link to the corresponding JIRA issue:

QAComplete integration with JIRA: QAComplete item synchronized with JIRA item

Click the image to enlarge it.

In JIRA, synchronized issues have a link to the corresponding QAComplete defect or requirement:

QAComplete integration with JIRA: JIRA item synchronized with QAComplete item

Click the image to enlarge it.

Click the link to open the corresponding item.

In QAComplete, synchronized items have JIRA keys leading to the corresponding JIRA items. Currently, this feature is supported for requirements and defects:

QAComplete integration with JIRA: JIRA item keys on the item list

Click the image to enlarge it.

Note: If you change the type of a JIRA item (for example, move it from Bug to Story), QAComplete items synchronized with it will not change their type.
Known limitations
  • Currently, JIRA items of the Sub Task type cannot be synchronized with QAComplete items.

  • The cross-referencing links between items are not synchronized. For example, if a JIRA issue has links to other JIRA issues, those links will not be copied to the appropriate QAComplete item.

  • One-to-many synchronization limitation: If you use a QAComplete version earlier than 11.7 and have a QAComplete item (for example, a requirement) synchronized with several JIRA items (for example, Task, Story, and Epic), you can face the following scenario:
    1. When you create a new item (for example, a Task) in JIRA, the appropriate item (Requirement) will be created in QAComplete.

    2. Based on the created QAComplete item, items of the appropriate types (Story and Epic) will be created in JIRA.

    3. The QAComplete item will contain links to all JIRA items with which it is synchronized.

  • In JIRA, it is possible to apply the wiki-style markup to text in item fields. Some of these tags are not supported in QAComplete. Please check the table in the section below for reference.

    List of unsupported JIRA tags

Move items between JIRA projects

When working with QAComplete and with the synchronized JIRA instance, and when moving items from one project to another, please take into account the following behavior:

  • When you delete a synchronized item from a JIRA project, the QAComplete item will be deleted as well.

  • When you move an item from a non-synchronized JIRA project to a synchronized JIRA project, a new connected item will be created in QAComplete.

  • When you move an item from a synchronized JIRA project to another JIRA project, the connected QAComplete item will be removed.

    If the JIRA project that stores the item after the transfer is integrated with another QAComplete project, a new item will be created. It will be identical to the deleted item, but there will be no history of changes.

The Integrations screen

On the  > Integrations page, you can prepare and configure your integration, and view the current state of the connection between your QAComplete and JIRA instances.

If you are a security administrator of the project you are currently working with, use the options available to you there to configure synchronization.

JIRA integration panel: Admin mode

Click the image to enlarge it.

If you are logged in as a user with no specific permissions, you can view the current state of the connection, the URL of your JIRA instance, and the time the items were last synchronized in QAComplete and JIRA. To configure the connection, contact your security administrator.

JIRA integration panel: User mode

Click the image to enlarge it.

Alternatives

The plugin supports QAComplete version 11.3 and later.

If you have an earlier version of QAComplete, you will have to use the QAComplete - JIRA Connector standalone service to synchronize items. In this case, please contact our Support Team.

See Also

QAComplete Integration for JIRA Plugin

Highlight search results