Skip to main content

Azure DevOps

Connect QA Hub to Azure DevOps to search work items (User Stories, Bugs, Tasks) from the Dashboard.

Prerequisites​

  • An Azure DevOps organization and project
  • A Personal Access Token (PAT) with Work Items: Read scope

Generate a PAT​

  1. Log in to dev.azure.com.
  2. Click your profile icon → Personal access tokens → New token.
  3. Grant Work Items: Read scope (read-only is sufficient).
  4. Set an expiry and click Create.
  5. Copy the token — it is shown only once.

Configure in QA Hub​

  1. Go to Settings → Integrations.
  2. Select Azure DevOps as your connector.
  3. Fill in:
    • Organization — Your ADO organization name (e.g., acme)
    • Project — Your ADO project name (e.g., MyApp)
    • PAT — Your personal access token
  4. Click Test connection.
  5. Click Save.

Searching work items​

QA Hub uses WIQL (Work Item Query Language) to fetch work items:

SELECT [System.Id], [System.Title], [System.Description]
FROM WorkItems
WHERE [System.TeamProject] = 'MyApp'
  AND [System.WorkItemType] IN ('User Story', 'Bug', 'Task')
  AND [System.Title] CONTAINS 'your query'

Results are fetched in batches and displayed with title, type, state, priority, and description.

Acceptance criteria extraction​

Azure DevOps stores acceptance criteria in an HTML field (Microsoft.VSTS.Common.AcceptanceCriteria). QA Hub strips the HTML and uses the plain text as context for AI test generation.

CSV import​

Azure DevOps test case exports (.csv) can be imported directly into QA Hub:

  1. Go to Test Cases → Import.
  2. Upload the ADO CSV export.
  3. QA Hub parses the steps from the XML-formatted ADO cells and converts them to Gherkin bdd_content.

This lets you migrate existing ADO test cases into QA Hub without re-generating them from scratch.