---
url: /howto/connecting-to-issue-trackers/azure-devops-work-items.md
description: This article describes how you can import work items from Azure DevOps Boards
---

# How to Connect Teamscale to Azure DevOps Work Items

:::tip General Option Reference
This guide only covers the options specific to the Azure DevOps work items.
A general overview of connector options is [available here](../../../reference/connector-options/#issue-tracker-connector-options).
:::

## Setup of the Azure DevOps Connector

1. Visit the Azure Marketplace and go to the [Teamscale plugin page](https://marketplace.visualstudio.com/items?itemName=CQSEGmbH.teamscale-azure-devops-plugin).
2. Choose your organization and click *Install*.\
   ![Install Plugin](./azure-devops-plugin-organization.png)
   * Click *Proceed to Organization* and select your project.
3. After successful installation, the Teamscale plugin will show up in the project settings under Extensions.\
   ![Teamscale Plugin successfully installed](./azure-devops-project-settings.png)
   * Click on the *Teamscale* extension and fill out the form according to [this guide](https://marketplace.visualstudio.com/items?itemName=CQSEGmbH.teamscale-azure-devops-plugin#setup) for the plugin and save.
4. Create a *Personal Access Token* for the project, if you don't already have one.

   * Go to *User Settings* and select *Personal Access Token*.\
     ![Create Personal Access Token](./azure-devops-user-settings.png)
   * Set the scopes for this token:
     * `Work Items`: Read, write, & manage
     * `Code`: Read
   * Click *Create*.

:::warning Store the Token immediately
Store the newly generated token in a safe place, because it will not be accessible anymore once the page is closed.
:::

5. In Teamscale, go to *Project Configuration* > *Projects*.
   Edit or [create a project](../../creating-a-project/).
   In the *Connector Configuration* section, click `+` and choose *Issue Tracker* > *Azure DevOps Boards*.

   * Add a new account by clicking on the `+` icon next to the `Account` field.
     ![Create Account Button](./azure-devops-create-account.png)
   * Fill out the following fields:
     * `URI`: URL of the projects' server
     * `API Key`: The *Access Token* that was created in the previous section.
       ![Screenshot of the Azure DevOps Account Creation Mask](./azure-devop-account-creation.png)
   * Click *Save*.

6. Fill out the following required fields in the connector settings:
   * `Projects`: Target project from the previous section
     ![Set projects](./azure-devops-connector-settings.png)

7. Fill out any additional filtering fields you want to use.
   For a work item to be imported, it must match all the provided filters.
   * `Areas`: The areas to extract work items from (full area paths).
   * `Include Sub-Areas`: If checked, work items from sub-areas are retrieved as well.
     Otherwise, just work items exactly matching one of the area paths are retrieved.
   * `Excluded Areas`: The areas to exclude from extracting work items (full area paths).
   * `Exclude Sub-Areas`: If checked, work items from sub-areas declared in `Excluded Areas` are excluded as well.
     Otherwise, just work items exactly matching one of the area paths are excluded.
   * `Iterations`: The iterations to extract work items from (full iteration paths).
   * `Include Sub-Iterations`: If checked, work items from sub-iterations are retrieved as well.
     Otherwise, just work items exactly matching one of the iteration paths are retrieved.
   * `Excluded Iterations`: The iterations to exclude from extracting work items (full iteration paths).
   * `Exclude Sub-Iterations`: If checked, work items from sub-iterations declared in `Excluded Iterations` are excluded as well.
     Otherwise, just work items exactly matching one of the iteration paths are excluded.
   * `Tags`: Import work items with containing any of these tags.
   * `Excluded Tags`: Do not import work items containing any of these tags.
   * `Item Types`: Only import work items of these types. Leave empty for all item types.
     ![Configure filters](./azure-devops-filter-settings.png)

8. Click `Save project` and wait for the finished reanalysis.

9. The work items can be found under *Activity* > *Issues*.
