Configuring the Jira server

After the administrator of the Jira server sets up the application link in Jira by using both the public and consumer keys, you can configure the Jira server for your project on IBM® Rational® Test Automation Server where the tests are available.

Before you begin

You must have completed the following tasks:
  • Generated a public key and a consumer key on Rational® Test Automation Server. See Generating public and consumer keys.
  • Shared both the keys with the administrator of the Jira server to set up an application link in Jira.

About this task

When you share both the keys with the administrator of the Jira server, the administrator of the Jira server sets up the application link in Jira.

After the completion of setting up of the application link by the administrator of the Jira server, you can then open the Change Management System tab of your project and complete the authorization process to configure the Jira server for your project on Rational® Test Automation Server.

Tasks performed by the administrator of the Jira server

As an administrator of the Jira server, you must perform the following actions to set up an application link on the Jira server:

  1. Log in to the Jira server and open the Configure Application Links page.
  2. Enter the URL of the application, and then click Create new link.
  3. Verify the URL on the Configure Application URL page, and then click Continue to open the Link applications page.
  4. Enter the information for the fields specified as follows on the Link applications page, and then click Continue:
    • Application Name: Enter an application name. The application name must be unique. For example, HCL.
    • Application Type: Select the type of application from the Application Type drop-down list. The default selection is General Application.
    • Select the Create incoming link check box.
    Note: You need not set other fields when you set up an application link to establish a connection between the Jira server and Rational® Test Automation Server.
  5. Enter the information on the Link applications page for the fields specified as follows, and then click Continue to set up the application link:
    • Consumer Key: Enter the consumer key shared by the administrator of Rational® Test Automation Server.
    • Consumer Name: Enter an application name. For example, HCL_1.
    • Public Key: Enter the public key shared by the administrator of Rational® Test Automation Server.

You have successfully set up the application link on the Jira server to establish a connection between the Jira server and Rational® Test Automation Server.

To know more about the application link, refer to the Configuring the client application as a consumer in Jira section.

Procedure

  1. Open your project.
  2. Expand Configure, and then click Project.
  3. Open the Change Management System tab.
  4. Click the Open action menu button from Jira Integration Details, and then click Configure.
    The Authorize User page is displayed.
  5. Complete the authorization process on the Authorize User page by performing the following actions:
    1. Click the authorization URL of the Jira server to open the Jira authorization page.
    2. Log in to your Jira server account with your valid credentials.
    3. Click Allow to authorize the Jira server account to generate an access token.

      The authorization is successful.

      The Access Approved page is displayed with a verification code.

    4. Copy the verification code, and then paste the verification code in the Enter Verification Code field on the Authorize User page.
    5. Click Save.
    The Configure Change Management System page is displayed.
  6. Select a Jira server project that is available from the Project drop-down list, and then click Update.
    Note: The change management system name and the change management system link are already displayed on the Configure Change Management System page.

Results

You have successfully configured the Jira server for your project on Rational® Test Automation Server.

You can see a tick icon green tick icon next to the URL of the Jira server on the successful configuration. You can also expand the Jira Integration Details section to see the project name of the Jira that you selected.

Note: You can delete the URL of the Jira server that you no longer require in your test environment.

What to do next

You can create defects for the tests available in your project and track the defects from the Results page on Rational® Test Automation Server after the test run is complete. See Creating Jira defects.