*If your integration is already configured and you want to learn about the actual usage of the integration, please go here*
The main advantage of this integration option is that it allows you to integrate your Jira Server or Jira DataCenter without any additional installations, and without using any plugins or add-ons.
On the other hand, if you choose to use the no-plugin integration with Jira, PractiTest panels (Linked Results and Linked Tests), that are available for users who are using the integration with PractiTest's plugin, will not be available for you in your integrated Jira tickets.
Note: The two-way integration is supported only under PractiTest’s Enterprise and Ultimate licenses.
Table of Contents
- Account integration settings
- Create an Application Link in your Jira Server / Datacenter
- Create a WebHook in Jira
- Project Settings: configure your integrated JIRA projects
- Field mapping configuration
- How to use JIRA 2 way integration
- JIRA – Two way integration troubleshooting
Account integration settings
In PractiTest, create an integration with 'Jira Server No Plugin'.
- Go to Account Settings - Integrations
Select ‘JIRA Server No Plugin’
- Paste your Jira Base URL
Click the 'Create token and continue with JIRA Server no plugin integration'.
Note: Only in case you would like to use the basic authentication method, check 'Use Basic authentication:' and enter username and password. This option is less recommended.
The following screen will appear:
Create an Application Link in your Jira Server / Datacenter
In Jira Administration (Settings), Select Applications and then select application links.
- In the Enter the URL of the application you want to link field, enter the base URL for your PractiTest App. Your app base URL can be found in PractiTest under Account Settings - Integrations.
- Click 'Create new link'
Fill in the fields with the data below:
- Application Name box type : PractiTest
- Application Type: accept the default value of Generic Application
- Click Continue
NOTE: If you’re prompted with the following message: ‘The supplied Application URL has redirected once. Please check the redirected URL field to ensure this is a URL that you trust’, check ‘Use this URL’ checkbox , click Continue and leave the new URL as is.
Configure the Application Link in Jira
Note: You’ll need to have the Public key, Consumer key and Callback URL from the PractiTest integration settings page
- Locate the PractiTest Application Link that you created in the previous section and click the Edit (pencil) icon.
- In the Configure dialog box, click Incoming Authentication on the bottom left and paste the following in the appropriate boxes:
- Consumer key: PTOauthKey
- Consumer Name: PractiTest Application
Consumer Callback URL:
*Please find your Consumer Callback URL in the PractiTest Account Integrations Settings window*
- Click the Save button, and then click Close
Note: In case you are not allowed to configure integrations by using application links, use the basic authentication method (less preferred) instead where username and password will be used.
Create a WebHook in Jira
Go to Jira - Administration (Settings) - System - scroll down to Webhook
Click ‘Create a WebHook’
- Paste the WebHook URL you got on the Integration Settings screen in PractiTest
- In the same window, scroll down to Events section - Issue related events. In the JQL text box, insert: project in ("your integrated projects separated by commas"). Under Issue events list, check 'updated'.
- Press 'Create'
Connect your PractiTest user to your Jira user:
Goto Project - Integrations. There, you will see a system message for linking the users. Click this message and the linkage will happen automatically.
Once done - you can set the project level integration settings.
Note: This JIRA user linkage is irrelevant when using the basic authentication method.
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 seperately.
Note: Linked Issue field 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, or Sprint type fields.
- 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 field 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.