Creating Jira issues for the test results

You can create Jira issues for the tests that ran in HCL OneTest™ Server. The issues are created in the project in Jira that you configured in HCL OneTest™ Server.

Before you begin

You must have completed the following tasks:

About this task

When you want to create a Jira issue in HCL OneTest™ Server, the issue types that display in the Create an issue in Jira dialog depend on the configuration done by the administrator of the Jira server.

The default fields that display on the Create an issue in Jira dialog are as follows:
  • Issue Type
  • Summary
  • Description
  • Attach Reports

If you want to view any additional fields in the Create an issue in Jira dialog from HCL OneTest™ Server, then you must inform your Jira server administrator to configure those additional fields as the required fields in the project on the Jira server. You can then use those fields in the Create an issue in Jira dialog when you create a defect from HCL OneTest™ Server.

You can refer to the Related information section to know more about Jira field configuration.

Procedure

  1. Log in to HCL OneTest™ Server.

    The team space that contains your project is displayed.

  2. Click Active projects > My projects > project_name to open the project that contains the test assets.

    The Overview page of the project is displayed.

  3. Click Analyze > Results.
    The Results page is displayed and all the test assets that were run earlier are displayed in tabs, as listed in the following table:
    Tab Description
    SUITES Lists all suites, Compound Tests, JMeter tests, JUnit tests, Postman tests, Rate Schedules, Selenium tests, or VU Schedules that are in the selected branch of the repository.
    TESTS Lists all API tests, functional tests, or performance tests that are in the selected branch of the repository.
    ADVANCED Lists all assets that are displayed when custom filters are applied for assets in the selected branch of the repository.
    Note: You can click the relevant tab to view the tests that were run earlier.
  4. Perform any of the following actions to identify the test asset:
    • Scroll through the list.
      Tip: You can hover over the icon in the Type column to know the type of the test asset.
      Note: You can also identify the type of the asset from the icon that represents the test type as shown in the following table:
      Icon Represents Listed in the SUITES tab Listed in the TESTS tab Listed in the ADVANCED tab
      API test image of checkmark image of checkmark
      Functional test image of checkmark image of checkmark
      Performance test image of checkmark image of checkmark
      AFT Suite image of checkmark image of checkmark
      API Suite image of checkmark image of checkmark
      Compound Test image of checkmark image of checkmark
      HCL AppScan CodeSweep image of checkmark image of checkmark
      JMeter Test image of checkmark image of checkmark
      JUnit Test image of checkmark image of checkmark
      Postman test image of checkmark image of checkmark
      Rate Schedule image of checkmark image of checkmark
      image of the selenium test icon Selenium test image of checkmark image of checkmark
      VU Schedule image of checkmark image of checkmark
    • Search for the test by entering any text that is contained in the test asset name in the Search field.

    • Select the time interval within which the test was run.

      For example, you can select the Last 24 hours option to view the tests that were run in the previous 24 hours.

    • Select the range of dates within which the test was run.

      You can click the calendar icon Image of the calendar icon. to select the date in the first image as the start date, and then select the date in the second image as the end date.

      Note: You can select the range of dates only when you select the time interval as Custom.

    • Click the Filter icon Image of the filter icon in the SUITES or TESTS tab, and then select the test type.

      All the tests based on the selected test type are displayed.

      For example, you can select API Suite in the SUITES tab to display all the API suites or you can select Functional Test in the TESTS tab to display all the functional tests.

    • Click the Filter icon Image of the filter icon in the ADVANCED tab, and then perform the following actions to create a filter query:
      1. Click New filter.
      2. Enter a name for the filter.
      3. Select an operator, and then select Add rule to add a rule or Add group to add a group of rules.
      4. Select or enter the relevant parameters, and then either select or enter the condition and the criteria for the condition.
        You can select a parameter from the following list:
        • ID
        • Type
        • Test
        • Version
        • Result
        • Started on
        • Finish on
        • Duration
        • Status
        • Verdict
        • Labels
        • Locked
        • Repository
        • Branch
        • Text
      5. Click Save.

        The filter query is saved and all the tests that match the filter criteria are displayed.

    • Perform the following actions in the ADVANCED tab to retrieve and apply a previously saved filter query:
      1. Click the Filter icon Image of the filter icon.

        All the filter queries that you created and saved earlier are displayed.

      2. Click the filter query that you want to apply.

        All the tests that match the filter criteria are displayed.

    You have identified the test that you want to use.

  5. Select the step that depends on the role assigned to you in the project on HCL OneTest™ Server:
    • If you are a member with a role assigned as Owner, go to Step 6.
    • If you are a member with a role assigned as Tester, and if you did not complete the one-time authorization process, go to Step 7.
    • If you are a member with a role assigned as Tester and completed the one-time authorization process, go to Step 8.
  6. Perform the following steps as the project Owner:
    1. Click the Jira: Create a Jira issue icon Create a Jira issue icon that is under the Actions column in the row of the test.

      Alternatively, you can click the test under the Test column to view the results panel, and then click the Jira: Create a Jira issue icon Create a Jira issue icon that is displayed in the panel.

      The Create an issue in Jira dialog is displayed.

    2. Go to Step 9.
  7. Perform the following steps as a member assigned the Tester role and if you have not yet completed the one-time authorization process:
    Note: You must complete the one-time authorization process if you are not a project owner.
    1. Click the Jira: Create a Jira issue icon Create a Jira issue icon that is under the Actions column in the row of the test.

      Alternatively, you can click the test under the Test column to view the results panel, and then click the Jira: Create a Jira issue icon Create a Jira issue icon that is displayed in the panel.

      The Configure Jira server to authorize the application dialog is displayed.

    2. Click the URL of the Jira server.
    3. Log in to the Jira server account with your valid credentials.
      Note: The Login page is displayed only if you are not already logged in to the Jira server.
    4. Read the message that is displayed, and then click Allow to authorize the Jira server account.

      After the authorization is successful, the Access Approved page is displayed with a verification code.

    5. Copy the verification code, and then enter the verification code in the field on the Configure Jira server to authorize the application dialog of HCL OneTest™ Server.
    6. Click Save.
    7. Go to Step 8.
  8. Perform the following steps as a member assigned the Tester role and completed the one-time authorization process:
    1. Click the Jira: Create a Jira issue icon Create a Jira issue icon that is under the Actions column in the row of the test.

      Alternatively, you can click the test under the Test column to view the results panel, and then click the Jira: Create a Jira issue icon Create a Jira issue icon that is displayed in the panel.

      The Create an issue in Jira dialog is displayed.

    2. Go to Step 9.
  9. Perform the following steps in the Create an issue in Jira dialog:
    1. Select the issue type that you want to create.
    2. Enter text for the title of the Jira issue. The name of the test is displayed as the default text in the Summary field.

      You can view the details of the test run that is displayed in the Description field. These details are appended to the Jira issue under the Description field, after you create the issue.

    3. Select the test reports or test logs of the test run that you want to attach to the Jira issue.
      Note: You can select any report, test log, or all the reports and the test log as attachments.
    4. Click Create.
      The issue is created in the project on the Jira server and the link to the issue is displayed in the Results panel of the test on HCL OneTest™ Server.
      Note: You can create multiple issues for the same test result, if you want.

Results

You have created issues in the Jira project for the test results from HCL OneTest™ Server.

The Jira issues are created in the Jira project and the links to the issues are displayed in the Details panel of the test result on the Results page.

What to do next

You can perform any of the following tasks: