Creating HCL® Compass work items

You can create HCL® Compass work items for the tests that ran on HCL OneTest™ Server. For example, you might want to create a work item in HCL® Compass when the test results differ from the expected results.

Before you begin

You must have completed the following tasks:

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. Perform the following actions on the identified test to create an HCL® Compass work item in HCL® Compass:
    1. Click the Compass: Create a work item 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 Compass: Create a work item icon that is displayed in the panel.

      The Create a work item in Compass dialog is displayed.

    2. Select the application from the list in the Application field.
      Remember: The application that you select must be the application for which you ran the test.
    3. Enter the username in the Username field.
      Note: The username is authorized to access the HCL® Compass server.
    4. Enter the password in the Password field to authenticate the username.
      Note: After the credentials that you provided in the Username and Password fields are authorized by the HCL® Compass server, you need not enter these values for subsequent connections to create a work item.
    5. Click Next.

      The dialog displays the URL of the HCL® Compass server and the Application that you selected.

    6. Select the work item type as WorkItem.
    7. Click Next.
    8. Select the project from the list in the Project field.
    9. Select the type of the work item from the list in the Type field.
    10. Enter text that is to be used as the title of the work item in the HCL® Compass work item.

      You can view the details of the test run in the Description field, which is appended to the work item that is created for the test run in HCL® Compass.

    A work item is created in HCL® Compass and a link to the work item is created in the Report panel of the Results page.
    Notes:
    • You cannot delete the work item that is created in HCL® Compass from HCL OneTest™ Server.
    • You can create multiple work items for the same test result, if required.

Results

You have created a work item in HCL® Compass from the Results page for the test that ran on HCL OneTest™ Server.

What to do next

You can perform any of the following tasks: