Step 2 — Setup Guide

Adding Work Item Types

ADO Test Management uses native Azure DevOps work items to store test data. Before you start, you need to register the required work item types in your organization using our PowerShell setup script.

Overview

The extension requires four work item types to be present in your Azure DevOps organization:

Test Collection

Top-level container for test suites and test cases

Test Suite

Groups related test cases within a collection

Test Case

Individual test with defined steps and expected results

Test Run

A snapshot of selected test cases for a focused execution cycle

Prerequisites

Azure DevOps organization administrator access
PowerShell 7+ installed (Windows, macOS, or Linux)
Azure DevOps Personal Access Token (PAT) with Process and Work Items scopes
ADO Test Management extension already installed from the Marketplace

Setup Steps

1Download the setup script

Download the setup-work-item-types.ps1 script from the ADO Test Management documentation repository.

PowerShell

# Download the setup script
Invoke-WebRequest -Uri "https://docs.vonobbo.com/ado-test-manager/setup-work-item-types.ps1" `
  -OutFile "setup-work-item-types.ps1"

2Run the script with your organization details

Provide your organization URL and Personal Access Token. The script will call the Azure DevOps REST API to register all required work item types automatically.

PowerShell

./setup-work-item-types.ps1 `
  -OrganizationUrl "https://dev.azure.com/your-org" `
  -PersonalAccessToken "your-pat-here"

3Verify the work item types were created

In your Azure DevOps organization, go to Organization Settings → Boards → Process. You should see the four new work item types listed under your process template. Once confirmed, proceed to the configuration guide to customize the extension for your team.

Documentation in progress

The full setup guide including the downloadable PowerShell script, troubleshooting tips, and advanced configuration options will be published here soon. In the meantime, feel free to contact us and we'll walk you through the setup personally.