Creating Azure DevOps work items
You can create Azure DevOps work items for the tests that ran in IBM® DevOps Test Hub (Test Hub). The issues are created in the project in Azure DevOps that you configured in Test Hub.
- Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
- Configured Azure DevOps as a change management system in Test Hub for your project. See Configuring Azure DevOps as a change management.
- 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.
When you want to create a Azure DevOps work item on Test Hub, the fields that display in the Create a work item dialog depends on the configuration done by the Azure DevOps administrator.
-
Log in to Test Hub.
The Projects page of the initial team space is displayed.
-
Click My projects > project_name to open the project that contains the test assets.
The Overview page of the project is displayed.
-
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. -
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 Functional test Performance test AFT Suite API Suite Compound Test HCL® AppScan CodeSweep JMeter Test JUnit Test Postman test Rate Schedule Selenium test VU Schedule - 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
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
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
in the ADVANCED tab, and then perform the following actions to create a filter query:
- Click New filter.
- Enter a name for the filter.
- Select an operator, and then select Add rule to add a rule or Add group to add a group of rules.
- 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
- 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:
- Click the Filter icon
.
All the filter queries that you created and saved earlier are displayed.
- Click the filter query that you want to apply.
All the tests that match the filter criteria are displayed.
- Click the Filter icon
You have identified the test that you want to use.
- Scroll through the list.
-
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.
-
Click the Azure: Create work item icon
You created work items in the Azure DevOps project for the test results from Test Hub.
The work items are created in the Azure DevOps project and the links to the work items are displayed in the Details panel of the test result on the Results page.
- View details of the Azure DevOps work items that you created in Azure DevOps for the test. See Viewing details of the Azure DevOps work items.
- Modify the configuration that you set for Azure DevOps on Test Hub. See Managing the Azure DevOps configuration.