Edit

Share via


Test objects and terms

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Read this article to gain an understanding of the objects and terms used in manual and exploratory testing.

Prerequisites

Category Requirements
Project access Project member.
Access levels At least Basic access. For more information, see Manual test access and permissions.

Test-specific work item types

To support manual and automated testing, add and group three main types of test-specific work item types: Test Plans, Test Suites, and Test Cases. To support sharing of various test steps and test parameters, define Shared Steps and Shared Parameters. The work tracking data store stores these objects as specific types of work items.

Test management work item types

The following table describes the work item types used to support the Azure DevOps test experience. Test-specific work items link together by using the link types shown in the previous image.

Work item type

Description


Test plans

Group test suites and individual test cases. To define a test plan, see Create test plans and test suites.

Test suite

Group test cases into separate testing scenarios within a single test plan. Grouping test cases makes it easier to see which scenarios are complete. When creating a test suite, you can specify one of three types:

  • Static test suites: Used to group test cases under a single test suite.
  • Requirement-based suites: Select one or more requirements from a query that you link to the test suite.
  • Query-based suites: Select one or more test cases that you link to the test suite.

Tip

The Test Suite Type read-only field indicates the type of suite selected. To add test suites, see Create test plans and test suites.

Test cases

Define the steps used to test code or an app for deployment. Define test cases to ensure your code works correctly, has no errors, and meets business and customer requirements. You can add individual test cases to a test plan without creating a test suite. More than one test suite or test plan can refer to a test case. You can effectively reuse test cases without needing to copy or clone them for each suite or plan. There are two types of test cases:

  • Manual: Test cases that define different steps that you run by using Test Runner or other supported client.
  • Automated: Test cases that are designed to run within an Azure Pipeline.

Tip

You can create a test case that automatically links to a requirement—User Story (Agile), Product Backlog Item (Scrum), Requirement (CMMI), or Issue (Basic)—when you create a test from the board. For more information, see Add, run, and update inline tests.

Shared steps

Use to share steps between multiple test cases. For example, log-in and verify steps for signing into an application are steps that you can share across a number of test cases. To learn how, see Share steps between test cases.

Shared parameters

Use to specify different parameters for executing test a test step within a test case. To learn how, see Repeat a test with different data.


Common fields for all test-specific work item types

Most work items include the following fields and tabs. Each tab tracks specific information, such as history, links, or attachments. These three tabs provide a history of changes, view of linked work items, and ability to view and attach files.

The only required field for all work item types is Title. When you save the work item, the system assigns it a unique ID. The form highlights required fields in yellow. For information about test-related fields, see Query based on build and test integration fields. For all other fields, see Work item field index.

Field

Usage


Enter a description of 255 characters or less. You can always modify the title later.

Assign the work item to the team member responsible for performing the work. The people picker searches for and lists users across the connected tenant. For more information, see People picker.

Note

You can only assign work to a single user. If you need to assign work to more than one user, add a work item for each user and distinguish the work to be done by title and description.

When you create the work item, the State defaults to the first state in the workflow. As work progresses, update it to reflect the current status.

Use the default first. Update it when you change state as need. Each State is associated with a default reason.

Choose the area path associated with the product or team, or leave it blank until assigned during a planning meeting. To change the dropdown list of areas, see Define area paths and assign to a team.

Choose the sprint or iteration in which to complete the work, or leave it blank and assign it later during a planning meeting. To change the drop-down list of iterations, see Define iteration paths and configure team iterations.

Provide enough detail to create a shared understanding of scope and support estimation efforts. Focus on the user, what they want to accomplish, and why. Don't describe how to develop the product. Provide sufficient details so that your team can write tasks and test cases to implement the item.


Common controls to all test-specific work item types

Several controls appear in several test-specific work items, as described in the following table. If you're not interested in these controls, you can hide them from the work item form layout as described in Add and manage fields (Inheritance process).

Control

Description


Deployment

Provides insight into whether a feature or user story is deployed and to what stage. You gain visual insight into the status of a work item as it's deployed to different release environments as well as quick navigation to each release stage and run. You can access this control from Test Plans, Test Suites, and Test Cases.

Development

Records all Git development processes that support completion of the work item. Typically, you use it to drive Git development from a requirement. This control supports traceability by providing visibility into all the branches, commits, pull requests, and builds related to the work item. You can access this control from Test Plans, Test Suites, and Test Cases.

Related Work

Use this control in Test Plans, Test Suites, and Test Cases to show or link to other work items such as requirements and bugs, usually through the Related link type.

Test Cases

Use this control in Shared Steps and Shared Parameters work items to indicate or link to Test Cases.


Customize test-specific work item types

For the Inherited process, you can customize test plans, test suites, and test cases. For the On-premises XML process, you can customize all test-specific work item types. For more information, see Customize work tracking objects to support your team's processes.

Permissions for test work items

Project-level and Area Path permissions control which tasks you can perform with test-specific work items, such as creating test runs, managing test plans, and managing test suites. You can't change the work item type of test-specific work items, even though the option appears on the work item form.

For the full list of permissions, default security group assignments, and access level requirements, see Manual test access and permissions. To set permissions, see Set permissions and access for testing.

Export, import, and bulk update test work items

You can bulk edit test-specific work items the same way you bulk edit other work items. For more information, see Bulk import or export test cases, Bulk modify work items, and Test suites context menu options.

Test terms

The following table describes several terms used in manual and exploratory testing.

Term

Definition


Configuration

Specifies the unique environment used to test an application or code. To define a test configuration, first define the configuration variables, and then define the test configuration. For details, see Test different configurations.

Configuration variable

Specifies a single aspect of a test environment such as an operating system, processing power, web browser, or other variation. For details, see Test different configurations.

Failure type

A categorization applied to test cases marked as Failed to classify the nature of the failure. Default failure types include Regression Issue, New Issue, Known Issue, and Not a Failure. Teams can define custom failure types by using the REST API. For details, see Manage test failure type.

Outcome

Outcome of a test point as marked by the tester upon executing the test. Valid options are:

  • Active (Unspecified)
  • Pass Test
  • Fail Test
  • Block Test
  • Not Applicable

For more information, see Repeat a test with different data. Note that pipeline test outcomes differ as described in About pipeline tests.

Test iteration

A single pass through a test case using a specific set of parameter values. When a test case uses parameters or shared parameters, each unique combination of values creates a separate test iteration. For details, see Repeat a test with different data.

Test points

Test cases by themselves aren't executable. When you add a test case to a test suite, test points are generated. A test point is a unique combination of test case, test suite, configuration, and tester.

For example, if you have a test case named Test sign in functionality and you add two configurations for the Microsoft Edge and Chrome browsers, you have two test points. You can execute or run each of these test points. On execution, test results are generated. Through the test results view, or execution history, you can see all executions of a test point. The latest execution for the test point is what you see in the Execute tab.

Test result

The recorded outcome of a single test case execution within a test run. Each test result captures whether the test passed, failed, or had another outcome, along with diagnostic data and attachments. For details, see Review test runs.

Test run

A logical grouping of test results created when one or more test cases are executed. The system creates a test run when you run test cases from a test plan or pipeline. Each test run captures outcomes, duration, environment, and diagnostic data. For details, see Review test runs.

Test run settings

Dialog used to associate test plans with a build or release pipelines.

Test outcome settings

Dialog used to choose how test outcomes in multiple suites under the same test plans should be configured.

Test step

An individual action within a test case, consisting of an Action (what the tester does) and an Expected Result (the anticipated behavior). During execution, each test step is marked as passed or failed. Test steps can reference shared steps and include attachments. For details, see Create test cases.

Traceability

Ability to trace test results with the requirements and bugs that they are linked to.

User acceptance testing (UAT)

A testing approach in which business stakeholders or end users verify that delivered functionality meets customer requirements. In Azure Test Plans, you can assign testers to test suites, send email invitations, and track progress through charts. Users with Stakeholder access can participate. For details, see User acceptance testing.