Support Center

JIRA integration

Last Updated: Mar 18, 2015 09:31AM IST
Devoted to your JIRA issue tracker? At PractiTest, we understand… and so we’ve enabled integration with JIRA, leading to the seamless management of a comprehensive end-to-end QA and development process using both these great solutions. 
Following really simple setup, JIRA is automatically updated with issues arising during testing with PractiTest, though you can still add details in JIRA about each issue. PractiTest also allows you to present 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

One-way and two-way integration – how they work
  - Configuring PractiTest for one-way integration with JIRA
  - Configuring PractiTest for two-way integration with JIRA
     - Add and configure the JIRA plugin
     - Add the pt_id custom field to JIRA​
     - Final step - Configuring integration with JIRA
Ready to roll: Running tests in PractiTest, seeing issues in JIRA
 - Steps to follow for both one-way and two-way integration
Multi projects and Multi types
See the 2-way integration explanatory video


One-way and two-way integration – how they work

Once the systems are (easily) configured and integrated, issues detected during testing in PractiTest automatically open a new issue form in JIRA with all the data (steps and actual results) already pre-entered. This is the case for both one-way and two-way integration.
With one-way integration, a link is placed in PractiTest to the issue in JIRA. 

With two-way integration, the new PractiTest link to the issue in JIRA is automatically updated with the name of the issue and its status; the two systems are always in sync, eliminating the need to enter JIRA to check issue status. 

Note: The two-way integration is supported only under PractiTest's Enterprise license




Configuring PractiTest for one-way integration with JIRA

As mentioned, configuring PractiTest to integrate with JIRA is simple. Follow these instructions:
  1. In PractiTest, go to Settings > Project , and activate the Issue Integration Support (click on the 'Activate' link). 
    Jira Integration
  2. Once you’ve chosen the JIRA System to integrate to, enter the URL Prefix that will be used by PractiTest to connect to your JIRA instance.
    The URL Prefix should look like this: http://your_server_name/
  3. Each project in JIRA has its own unique ID (usually a number starting from 10,000). You must enter the ID in the "JIRA project id" field for your configuration.   

    Please note: JIRA's project name / project prefix IS NOT its project ID.  
    JIRA's project ID can be found within JIRA in many places when looking at the url, for example: 
    When selecting a project (in JIRA), and clicking on the Reports menu -> "Workload Pie Chart Report" (first item), the url follows this format:  http(s)://[JIRA PREFIX]/secure/ConfigureReport!default.jspa?selectedProjectId=10000&reportKey=com.atlassian.jira.ext.charting:workloadpie-report
    So, in this example, the project id you need is 10000.
  4. Click the "Create Issue Integration" button to activate the integration. 

Configuring PractiTest for two-way integration with JIRA

Configuring PractiTest for two-way integration is very similar to configuration for one-way integration, however - prior to starting those steps, you will need to add and configure the designated JIRA plugin for PractiTest*:

Add and configure the JIRA plugin:

JIRA Server (on Permise / you host) - (see next for JIRA cloud)
  • Login to JIRA as Administrator
  • Click on the “Administration” link on the top right
  • Click Manage Plugins and then Upload Plugin

  • Upload the jar file from this link
  • Click configure under ‘practitest-jira-lite’
  • Fill out the api-key, secret key and Host. The Host should be either OR (if you're evaluating the integration on demo project). To retrieve the API keys, go to your Account Settings (only under the Enterprise license)
*Please note: The PractiTest plugin for JIRA is supported for JIRA-4 and above
JIRA Cloud (Atlassian Host)
  • Click on Settings -> JIRA Administrations -> Add-Ons, search for PractiTest, and click Manage

    Goto: and click on the "Get it now" green button.
  • After it's installed, open the "PractiTest Integration AddOn", and click on the configure key:
  • Fill out the api-key and secret key and Host. To retrieve the API keys, go to your Account Settings (only under the Enterprise license)
​​*Please note: The PractiTest addon for JIRA cloud works only on production environment (ie only)

Add the pt_id custom field to JIRA​

  • Add the pt_id custom field to JIRA
  • ​​Add a custom field named "pt_id" to JIRA and set it to 'integer'.  Please notice that this custom field needs to be defined in lowercase characters (this setting is case-sensitive).
  • Administration -> “Issues” -> “Fields”

  • Add a Custom Field:
    • Choose “Number Field” and click “Next”
    • Field name: pt_id
    • Description (options): PractiTest internal integration issue id for status synchronization
    • Select "Global Context" if you with PractiTest to synchronize issues with all of your projects
    • Click Finish
  • Associate field pt_id to screens - select “Default Screen” and click “Update”
  • Find the ID of the custom field:
    • Fields -> Go to Settings -> Edit (see screen shot)
    • The url in your browser will follow this format: http://your_server_name/secure/admin/EditCustomField!default.jspa?id=10300
    • In the example above, the ID is 10300. Copy down the ID since you will need it later on.

   Final step - Configuring the integration with JIRA

  • Configure PractiTest (similar to the one-way synchronization)
  • Go to Settings -> Project
  • In the Issue integration support area, click the "Settings" link
  • Select JIRA, enter the url prefix, and the project prefix
  • Enter the ID you copied down for the pt_id field (in the example above, it is 10300). ​


Ready to roll: Running tests in PractiTest, seeing issues in JIRA

   Steps to follow for both one-way and two-way integration:

  1. Run your tests normally.
    When you encounter an issue click the Fail & Issue icon (or prior to that, save the “Step’s Actual Results”). 

    seeing issues in JIRA
  2. A new browser tab or window (based on the configuration of your browser) will be launched opening your JIRA new issue page.  You will see all the test data already pre-entered, including the summary and description pre-filled with steps you’ve executed, and the failed “Step’s Actual Results” (if this information was already entered in PractiTest). You may add more details to the issue. Then Save.


    (Note: for TWO-WAY INTEGRATION, steps 3-4 are performed automatically.)
  3. After reporting the issue take note of the new JIRA ID and go back to PractiTest, where you should enter this ID in the Issue ID field and click the Link to Step button. You can enter multiple issues at once by separating them using commas or spaces. 
  4. The JIRA Issue will be linked to the test step, and clicking the issue ID will open it in a new window in your JIRA Instance.

    TWO-WAY INTEGRATION enjoys the additional advantage of automatic synchronization:

  5. Having saved the Issue (step 2), the plugin does the rest, keeping the issue and test step synchronized. PractiTest will continue to be updated even when you change issue status or name.
See the 2-way integration explanatory video.

Multi projects and Multi types

Set different project and different issue types to open directly in JIRA.

This is the configuration -

multiple project issue configuration

Once you run the test, when you put your mouse over 'Fail and Issue' you can select which project or type (based on your previous configuration) you'll open in Jira.

If you have any questions, please don’t hesitate to contact us!

Contact Us
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found