Configure Jira integration in Katalon Studio

This article shows you how to configure Jira integration in Katalon Studio.

Requirements

• An active Katalon Studio Enterprise license.
• Install the suitable Jira Integration plugin version for Katalon Studio. You can find the plugin here: Jira Integration plugin.
• In Jira, install the plugin from the Atlassian Marketplace website: Katalon Studio and TestOps integration.

Enable Jira integration in Katalon Studio

To enable Jira integration in a Katalon Studio project, follow these steps:

1. In Katalon Studio, go to Projects > Settings > Plugins > JIRA.
2. Select the Enable integration checkbox.
3. In the Authentication section, fill in the criteria as shown below:

   • Server URL:

     • For Jira Cloud: https://<site_name>.atlassian.net
     • For Jira Data Center (Jira Server): https://domain without any trailing parts, for example, /secure. Your server URL for Jira Data Center should have a valid SSL certificate.

   • Username: your username or the registered email of the Atlassian account.

   • Password/API token: The Atlassian Cloud's API token. To learn more about generating API in Atlassian, you can refer to the Atlassian document: Manage Atlassian token for your Atlassian account.

4. Click Connect to start the authentication process. A pop-up dialog indicates that the Atlassian account connects successfully.
5. After successfully authenticating with Jira, all relevant JIRA Projects and Issue Types will be retrieved and displayed under the Submit Options section. You can specify the default project and the default issue type for submission here.

   Field	Description
   Default Jira Project	The default Jira project to submit tickets.
   Default Jira Issue Type	The default Jira issue type to create when submitting tickets.
   Use Test Case name as Summary for Jira ticket	To use the test case name as a summary for submitted tickets.
   Attach Screenshot to Jira ticket	To include taken screenshots during test execution in submitted tickets.
   Attach Log to Jira ticket	To include the execution log in submitted tickets.

   
6. Click Apply and Close to complete the Jira integration.

You have successfully enabled Jira integration in Katalon Studio.

Note:

• Jira integration configuration is available in the project scope only. If you want to integrate Jira with another Katalon project, you have to repeat the above steps.

Import BDD custom fields from Jira to Katalon Studio (Applicable to Jira Cloud integration)

• This step is necessary if you want to conduct BDD testing with Jira. If you don't run BDD tests or you are integrating Jira Data Center (Jira Server) with Katalon, skip this section and move to Import test cases from Jira to Katalon Studio.

• You have configured the Katalon BDD fields in Jira. See: Manage BDD test cases with Jira integration.

From Katalon Studio version 7.8.0 onwards, you can import the BDD custom fields to Katalon Studio when importing BDD feature files for Jira Cloud integration. Follow these steps:

1. Go to Projects > Settings > Plugin > Jira.
2. In the Fetch Options section, check the Enable retrieving content of the specified custom field box.
   
3. Select a custom field from the dropdown list.
   Note:

   • Only the existing custom field ID is valid for this configuration.
   • In case you can not find the custom field in the dropdown list, click Fetch Custom Fields to fetch the latest list from the connected Jira Cloud.
4. Click Apply and Close to apply your settings.

You have successfully imported BDD custom fields from Jira to Katalon Studio. You can now start importing your BDD test cases to Katalon Studio to execute and view test results.

Import test cases from Jira to Katalon Studio

Katalon Studio allows you to pull test cases from Jira and link Jira issues to Katalon. Follow these steps:

1. From the Katalon toolbar, select Jira > Import Test Case from JIRA JQL. An Import Test Case from JIRA JQL dialog opens.
   
2. In the open dialog, fill the JIRA Query Language (JQL) script of the desired test case in the Jira JQL box. To find out the JQL script of your test case, you can refer to the Atlassian document here: Search for issues using JQL.
   For example, we want to import test cases from the TDAP project with Bug type and Complete status. After searching for the Jira ticket using the JQL query, copy and paste the JQL script into the Jira JQL box.

   

   

3. Optional: By default, the Import BDD feature files box is selected. This option allows you to import BDD feature files to run BDD tests. In case you don't want to run BDD tests, uncheck this option.
4. Click OK.
5. The Test Case Folder Selection dialog opens. Select the destination to store the issues. Click OK.
6. A Jira Issues dialog opens. Click OK to import the test case from Jira.
   Note:

   • You can only import test cases from a Jira ticket once. You can not repeat this action.

Once done, you can see a new test case in Katalon Studio with the following information:

• The test case name is the Jira ticket summary/subject.

• The test case description is the Jira ticket content.

• If you select Import BDD feature file as in step 3, Katalon Studio creates a new corresponding feature file in Include/Feature with the following information:

  • The feature file name is the same as the test case name.

  • The scenario in the feature file is the scenario specified in the fetched BDD custom field of the imported Jira ticket.

    

    

You can continue to add additional steps in the test case as needed. Then click Run for playback.

After importing test cases from Jira to Katalon Studio, you can view test results and submit tickets to Jira.

If you conduct BDD testing, you can view the results in Katalon TestOps. See View BDD test results in Katalon TestOps.