Creating Azure DevOps work items

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

Before you begin

You must have completed the following tasks:

Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to server projects.
Configured Azure DevOps as a change management system in HCL OneTest™ Server for your project. See Configuring Azure DevOps as a change management system.
Extended the CA list. See Extending the trusted CA list on Linux or Extending the trusted CA list on Windows systems.
Configured a test run. See Test run configurations.
Viewed the results of the completed test runs on the Results page. See Test results.

About this task

When you want to create a Azure DevOps work item on HCL OneTest™ Server, the fields that display in the Create a work item dialog depends on the configuration done by the Azure DevOps administrator.

Procedure

Log in to HCL OneTest™ Server.

The team space that contains your project is displayed.
Click Active projects > My projects > project_name to open the project that contains the test assets.

The Overview page of the project is displayed.

Open the Results page by clicking Analyze > Results.

The test assets that ran are displayed in the following tabs on the Results page:


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.

You can click the relevant Tab to view the tests that you ran.

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
	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:
1. Click New filter.
2. Enter a name for the filter.
3. Select an operator, and add a rule, or a group of rules.
4. 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
5. 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.
1. Click the Filter icon in the ADVANCED tab.
  The filter queries that you created and saved are displayed.
2. Click the filter that you want to apply.
  The tests that match the filter criteria are displayed.

You have identified the test that you want to use.

Perform the following actions on the test that was run to create a work item:

Click the Azure: Create 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 Azure: Create work item icon that is displayed in the panel.

The Create a work item dialog is displayed.

Perform the actions indicated in the following table for each of the fields:


Field	Description	Action
Project	The name of the Azure DevOps project.	Select the Azure DevOps project from the drop-down list.
Work item type	The type of work item.	Select the work item you want to assign for the test asset.
Title	A title that identifies the work item.	Specify a title for the work item.
Description	A detailed description of the work item.	Enter a description of the work item.

Note: The other fields selected as Required fields on the Azure DevOps project are displayed in the Create a work item dialog.

Enter the information for all the required fields, and then click Create.

Note: You can create multiple work items for the same test result, if required.

Results

You created work items in the Azure DevOps project for the test results from HCL OneTest™ Server.

What to do next

You can click the test result on the Results page to view the Azure DevOps work item links. You can then click the work item link to open the work item and view the details of the work item in Azure DevOps.