*If your integration is already configured and you want to learn about the actual usage of the integration, please go here*
PractiTest’s integration with JIRA Cloud, enables a seamless workflow and better test management for the entire QA process. After a simple configuration process, PractiTest allows you to manage and present any issues or requirements created in JIRA, as well as generate issues into JIRA. The Integration is continuously and automatically updated between the two, allowing a single, uniform view covering requirements, tests, and issues. Comprehensive Test Execution reports including test runs and issues detected during the process can be easily generated.
Table of Contents
- Account integration setttings
- Project Settings: configure your integrated JIRA projects
- Field mapping configuration
- How to use JIRA 2 way integration
- JIRA – Two way integration troubleshooting
Account integration setttings
In PractiTest, go to the Account Settings - Integrations tab.
- Press 'Create a new 2-way account integration'
- Select Jira Cloud
- Enter the base URL of your Jira Cloud instance (e.g., xxx.atlassian.net or xxx.jira.com) and press 'Register' If you encounter an issue please contact our support.
- Press on ‘Create a new Jira Cloud integration’. You should receive your integration API token in the next screen.
In Jira, go to Jira Settings - Apps - Find new apps - Search for PractiTest - Download the PractiTest plugin.
Click on ‘Manage Apps’ - Paste the API token you got on step 1 - Select the Jira projects you want to integrate with PractiTest (or leave empty to integrate all projects) - Click 'Submit'.
Configure your integrated JIRA projects:
- In PractiTest, go to Settings - Integrations - press 'Activate' on issue integration section - and then press ‘activate’ again on the Jira integration configured in your account.
- Add a new row for each of the Jira projects you want to integrate with this PractiTest project, select the relevant project and issue type.
- At the bottom of the page you can allow PractiTest to create internal issues that will not be synced to Jira. If you choose this option you will also have the choice to present the PractiTest ID for all issues including the Jira synced issues. If you do not choose to allow PractiTest to create internal issues, PractiTest will present the Jira ID for each issue.
Mapping your Jira fields to your PractiTest fields
Note: Field sync needs to be configured for each PractiTest project separately.
Note: Linked Issue field (for example "is blocked by" or "relates to") will be automatically added to the "Fail & Issue" modal box in case the project and the issue type you choose contain it, and you don't need to map it here.
In the project Integration settings window, press settings and choose the ‘Jira project mapped fields’ tab.
- Choose the Jira field you want to map. You can choose Text Fields, Single select lists (text, number, users), Multi-lists, Number, Date, Sprint, Epic link or Team type fields. (Team field can only be maaped when using Jira Cloud).
- Tick the “Add to ‘Fail & Issue’” box if you want this field to appear when reporting an issue from PractiTest to Jira.
- Choose if and where you want to map this Jira field to - to a PractiTest dedicated field, or to the description of the PractiTest entity. Please note: If you choose to map it to a field - the list of PractiTest fields that will appear will contain only custom fields that match the type of the Jira field you chose (text-text, number-number etc. Sprint, Epic link and Team fields can be mapped to list type fields in PractiTest) and are also linked to either requirements or issues. If you chose the Jira Priority field, you will be able to map it to PractiTest Priority system field.
- Once you choose to map to fields, you will need to choose whether to present the data in the issues field or in the requirement field, or both. If the PractiTest field you chose is linked only to one of them, then you will have only that option to map to.
Syncing Jira filters to keep updating PractiTest with its issues
To sync a Jira filter into PractiTest in a way that will keep syncing the issues in it to PractiTest, go to your project integration settings, choose the “Auto sync filters” tab. Choose the Jira filter you want to sync and the PractiTest entity you want to sync it to - Requirements or issues. Press “Update issue integration” and from now on, every 4 hours, PractiTest will sync to all the issues in this filter. You can add as many filters as you want but please note that if the filter contains issues from projects that are not integrated with PractiTest (as defined in the first tab “Jira Project info & issue type”), they will not be synced.