*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.

Table of Contents

Account integration settings

In PractiTest, create an integration with 'Jira Server No Plugin'.

  • Go to Account Settings - Integrations
  • Select ‘JIRA Server No Plugin’
    1. Paste your Jira Base URL Jira Server no-plugin configuration
    2. 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: Jira no-plugin updated

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:

      *Please find your Consumer Callback URL in the PractiTest Account Integrations Settings window*

    • 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").
      In the 'Issue' column underneath, check 'updated'. In the 'Issue Link' column, check 'Created' and 'Deleted'. In the 'Comment' column check 'created', 'Updated' and 'Deleted'. check webhook jira
    3. 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. Link Jira user

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. PractiTest integrations settings screen
  • 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. PractiTest Jira integrations settings screen

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.

Jira mapped fields in PractiTest
  1. 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).
  2. Tick the “Add to ‘Fail & Issue’” box if you want this field to appear when reporting an issue from PractiTest to Jira.
  3. 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.
  4. 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. Sync Jira filters to Practitest 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.