If your integration is already configured and you want to learn about the actual usage of the integration, please go here

Seamless management of a comprehensive end-to-end QA and development process using PractiTest and Jira great solutions. Following this simple setup, your JIRA Server instance will be automatically updated with issues arising during testing with PractiTest, though you can still add details in JIRA about each issue. PractiTest also allows users to present a single, uniform view covering requirements, tests, and issues.

Note: The two-way integration is supported only under PractiTest’s Enterprise and Unlimited licenses

Table of Contents

PractiTest Jira Server/DC Plugin ver 3.0.0 - Jira Server versions 7.3.1 and above and Jira DC versions 7.5.0 and above

Note: The configuration can only be set by a user with PractiTest account owner level permissions, and Jira admin-level permissions.

Configuration Steps

Account integration settings

In PractiTest:
  • Go to Account settings - Integrations tab - select JIRA Server and click the 'Create token and continue with JIRA Server 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 Jira Server select
  • The following screen will appear: Jira Server configuration
In Jira, Download and configure the plugin:
  • Click on the “Administration” link on the top right (Settings). Click on apps/add-ons (depends on the Jira version you are using) - 'Find new apps/add-ons' Find new addons Atlassian Marketplace
  • Search for PractiTest in atlassian marketplace.
  • In the manage apps/add-ons window, click PractiTest - Configure. Manage addons Jira marketplace
  • Fill in the API-Token you got in the PractiTest Account Settings into the Plugin configuration page.
    insert-api-token
  • By default, all Jira projects will appear as manageable in PractiTest. If you want to include only part of your Jira projects in PractiTest integration and exclude others, please check “Enable PractiTest addon for the following projects only”, and check the specific projects that you wish to integrate. Any project that you don’t check will not be integrated.
    Select projects to integrate
  • In the same page press show more
    api-insert-show-more.jpg
  • Fill in the URL fields as follows:
    1. The Host should be https://api.practitest.com/ for prod users (USA), and https://eu1-prod.practitest.app/ for EU users.
    2. The Proxy should be wss://proxy.practitest.com:443/ for prod users (USA), and wss://eu1-jira-proxy-prod.practitest.app:443/ for EU users.
    api-insert-url.jpg
  • Press save.

If you are working on PractiTest Jira plugin version up to 2.4.2, please scroll down for next steps.

Create an Application Link in your Jira Server / Datacenter

  • In Jira Administration (Settings), Select Applications and then select application links.

    app-link-settings
  • 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'
  • 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.

  • Fill in the fields with the data below:
    1. Application Name box type : PractiTest
    2. Application Type: accept the default value of Generic Application
      app-link-name
    3. Click Continue

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. practitest-app-link
  • 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
    • Public Key:
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxi5O5khVZEpqaVUG13mQw2PM/SCAdx8b2IvkOIJIBGgQe1UBATCUnENlbfAmU1y5VmzzlLxtnHq4E6gTtwCNQjPzwLtFV60Ys4kQG73j78CHw+oRGuza+PQiHZb6exwbaZmaNXaDbV0TuZzO4J/A3Qxo5vFWKlG0VI4Q3xfrv1fN6WJMeJLBlhbyFuC6qNTcYmXfIxPLMsTvvHvco/9ZjME+lyivUOHUj1YY4pqI4sIotLVjF5RXYfHQrLYJ/+3FBKnH0uAwj4dSyp+mVq3/IB5lI0GSnJo41xr1z0jY0M0bJEri+56rQqc0qs5lDWtDVvuzok4XvaCIy3MDnhOkPQIDAQAB
    • Consumer Callback URL:

      For Jira Server/Data center: [*PT_App_BASE_URL]/integrations/jira_oauth/set_oauth_verification_pl
      For Jira Server/Data center No Plugin: [*PT_App_BASE_UR*]/integrations/jira_oauth/set_oauth_verification

      [*PT_App_BASE_URL] = https://prod.practitest.com or https://eu1-prod.practitest.app

    • Click the Save button, and then click Close app-link-dialog-box

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
    new webhook jira
  • Click ‘Create a WebHook’
    1. Paste the WebHook URL you got on the Integration Settings screen in PractiTest
    2. 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'. PractiTest Webhook
    3. Press 'Create'

Go back to PractiTest - Account Settings - Integrations - and verify that the connection status is 'Connected' by pressing “Test Connection”.

Configure your integrated JIRA projects:

  • In PractiTest, go to Settings - Integrations - press 'Activate' on issue integration section - select the relevant Jira integration from the dropdown list.
  • 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. PractiTest project settings screen

Your PractiTest user will connect to your Jira user upon first time of either Import Issue/filter or Create Issue.

Upgrade from PractiTest Jira plugin version up to 2.4.2 - to plugin version 3.0.0

Configuration Steps

Update plugin in Jira

  • Click on the “Administration” link on the top right (Settings). Click on apps/add-ons (depends on the Jira version you are using)
  • Click ‘Manage add-ons/Apps’
  • In the ‘Manage add-ons/Apps’ window, click PractiTest - Update.
  • update-jira-3

Create an Application Link in your Jira Server / Datacenter

  • In Jira Administration (Settings), Select Applications and then select application links.

    app-link-settings
  • 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'
  • 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.

  • Fill in the fields with the data below:
    1. Application Name box type : PractiTest
    2. Application Type: accept the default value of Generic Application
      app-link-name
    3. Click Continue

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. practitest-app-link
  • 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
    • Public Key:
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxi5O5khVZEpqaVUG13mQw2PM/SCAdx8b2IvkOIJIBGgQe1UBATCUnENlbfAmU1y5VmzzlLxtnHq4E6gTtwCNQjPzwLtFV60Ys4kQG73j78CHw+oRGuza+PQiHZb6exwbaZmaNXaDbV0TuZzO4J/A3Qxo5vFWKlG0VI4Q3xfrv1fN6WJMeJLBlhbyFuC6qNTcYmXfIxPLMsTvvHvco/9ZjME+lyivUOHUj1YY4pqI4sIotLVjF5RXYfHQrLYJ/+3FBKnH0uAwj4dSyp+mVq3/IB5lI0GSnJo41xr1z0jY0M0bJEri+56rQqc0qs5lDWtDVvuzok4XvaCIy3MDnhOkPQIDAQAB
    • Consumer Callback URL:

      For Jira Server/Data center: [*PT_App_BASE_URL]/integrations/jira_oauth/set_oauth_verification_pl
      For Jira Server/Data center No Plugin: [*PT_App_BASE_UR*]/integrations/jira_oauth/set_oauth_verification

      [*PT_App_BASE_URL] = https://prod.practitest.com or https://eu1-prod.practitest.app

    • Click the Save button, and then click Close app-link-dialog-box

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
    new webhook jira
  • Click ‘Create a WebHook’
    1. Paste the WebHook URL you got on the Integration Settings screen in PractiTest
    2. 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'. PractiTest Webhook
    3. Press 'Create'

Delete pt_id

  • In Jira administration (Settings) window, go to ‘issues’, then scroll down on the left to ‘custom fields’
  • On the ‘pt-id’ custom field, click the settings icon on the right and press ‘Delete’. Press ‘Delete’ in the following screen as well.

Go back to PractiTest - Account Settings - Integrations - and verify that the connection status is 'Connected' by pressing “Test Connection”.

For PractiTest plugin version 2.4.2- Jira Server versions 7.3.1 and above and Jira DC versions 7.5.0 and above

Start configuring using the steps written above for plugin version 3.0.0 - Create Token in account settings in PractiTest, download the PractiTest plugin in Jira, configure it by filling in the API token you got in PractiTest, choose the Jira projects you want to integrate and confirm the plugin is connected (please scroll up for full description of the configuration first steps).

The next step is associating the pt_id field with the relevant screens. Follow these steps to create the field:

  • Goto Jira Settings - Issues - Custom Fields , find pt_id field, click cog icon - screens.
  • Check the boxes next to the screens of the projects you want to integrate with PractiTest and click 'Update'. Jira Screens

For PractiTest plugin version 2.3.27 - Jira Server versions 6.1 - 7.3.0

The ‘pt_id’ custom field will be automatically added to your JIRA custom fields after installing the PractiTest plugin.

In case you have many boards within JIRA project/s you would like to integrate with PractiTest, or you have screens dedicated for issue creation, please associate the ‘pt_id’ field with the boards’ screens/issue creation screens as well.

To do that, please go to JIRA Settings – Issues – Custom fields – press the ‘settings’ icon next to the ‘pt_id’ field – Screens.