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
- Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to server projects.
- Configured HCL® Compass as a change management system in HCL OneTest™ Server. See Configuring HCL Compass.
- Configured applications in HCL® Compass.
- Configured a test run. See Test run configurations.
- Viewed the results of the completed test runs on the Results page. See Test results.
Procedure
-
Log in to HCL OneTest™ Server.
The team space that contains your project is displayed.
-
Click
to open the project that contains the test assets.
The Overview page of the project is displayed.
-
Open the Results page by clicking .
The test assets that ran are displayed in the following tabs on the Results page:You can click the relevant Tab to view the tests that you ran.
Tab Description SUITES Lists all suites, compound tests, JMeter tests, JUnit tests, Postman tests, Rate Schedules, 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. -
Identify the test asset by performing any of the following
actions:
- 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 Functional test Performance test AFT Suite API Suite Compound Test HCL AppScan CodeSweep JMeter Test JUnit Test Postman test Rate Schedule VU Schedule - Search for the test by entering any text contained in the test asset name in the Search field.
- Select a time within which the test was run. For example, you can select the option Last 24 hours to view the tests that ran in the previous 24 hours.
- Select a date range within which the test was run. You can click the calendar icon to select the date in the first image as the start date, and then select the end date in the second image.
- Click the Filter icon in the SUITES or
TESTS tab to filter the displayed
tests based on the test type.
For example, select API Suite in the SUITES tab to display all API Suites or select Functional Test in the TESTS tab to display all functional tests.
- Click the Filter icon in the ADVANCED tab, and
then create a filter query by using the New
filter option by performing the following
steps:
- Click New filter.
- Enter a name for the filter.
- Select an operator, and add a rule, or a group of rules.
- Add or enter the relevant parameters and 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
- Save the filter query to save and apply the filter
query to filter the tests based on the query.
The tests that match the filter criteria are displayed.
- Retrieve and apply a saved filter query, if you have saved
filter queries previously by performing the following
steps:Note: The filter query applied previously is selected and the tests based on that filter query are displayed. To apply a different filter query, you must have created and saved the filter query.
- Click the Filter icon in the ADVANCED
tab.
The filter queries that you created and saved are displayed.
- Click the filter that you want to apply.
The tests that match the filter criteria are displayed.
- Click the Filter icon in the ADVANCED
tab.
You have identified the test that you want to use.
- Scroll through the list.
-
Perform the following actions on the identified test to create an HCL® Compass work item 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
- View details of the HCL® Compass work items that you created in HCL® Compass for the test. See Viewing details of the HCL Compass work items.
- Modify the configuration that you set for HCL® Compass on HCL OneTest™ Server. See Managing the HCL Compass configuration.