# Best practices for integrating Oobeya with Azure DevOps Scrum Boards

## Introduction

This guide outlines the best practices for integrating **Oobeya** with **Azure DevOps Scrum Boards** to enhance your project management through effective analytics. It focuses on managing processes, work item types, and state mappings to ensure accurate data analysis within Oobeya.

***

## Step-by-Step Guide

### 1. Access Organization Settings in Azure DevOps

* Log in to your Azure DevOps account.
* Click **"Organization settings"** at the bottom left corner of the Azure DevOps portal.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F3rSCWqXn2QMHmWA52PFR%2Fimage.png?alt=media&#x26;token=a914eefb-3251-42de-ab3c-be4671311f4f" alt=""><figcaption><p>Open Organization settings - Azure DevOps</p></figcaption></figure>

### 2. Navigate to the Process Section

* From the left-hand menu in the Organization settings, select **"Process."**
* A list of all available processes will be displayed.
* You can view how many projects are using each process.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F9DlkVajDr8lqXsx0PLeY%2Fimage.png?alt=media&#x26;token=26f441a2-0941-43e7-8419-79cff4e9b48d" alt=""><figcaption><p>Open the Process tab - Azure DevOps</p></figcaption></figure>

### 3. View Projects Associated with a Process

* Click on the process you want to examine.
* Navigate to the **"Projects"** tab within the process details.
* Here, you can see all the projects that are using this process.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FH5LVTmmuI0gQjO1U7xF9%2Fimage.png?alt=media&#x26;token=7ac1ea0d-1f45-4d42-a3b4-c32a071103b5" alt=""><figcaption><p>View all projects that are using the selected process</p></figcaption></figure>

### 4. View Work Item Types Used in Boards

* Within the process details, click on **"Work Item Types."**
* A list of all work item types used in the boards (e.g., Epics, Features, User Stories, Tasks) will be displayed.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FBQCGY1ddugZlV3Ubkqwn%2Fimage.png?alt=media&#x26;token=4e479093-7678-4d62-bbfe-4468b6e21ef0" alt=""><figcaption><p>Work item types - Azure DevOps Boards</p></figcaption></figure>

### 5. Review and Customize States for Each Work Item Type

* Click on a work item type to view its details.
* Under the **"States"** section, you can see all the states associated with that work item type.
* **Note:** Each work item type can have different states.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FsH9QLs7fGDxGv7w7Gv0w%2Fimage.png?alt=media&#x26;token=46c23c64-1826-42ad-ae13-655274babf7a" alt=""><figcaption><p>States for a work item - Azure DevOps Boards</p></figcaption></figure>

{% hint style="info" %}
Azure DevOps does not allow adding new states to the default processes.

**How to Create a Custom Process to Add New States**

* To add new states, you need to create a **custom process**.
* Follow the Azure DevOps documentation: [Change the process](https://learn.microsoft.com/en-us/azure/devops/organizations/settings/work/manage-process?view=azure-devops#change-the-process-used-by-a-project)
  {% endhint %}

### 6. Map States in Oobeya During AgileSpace Analysis Creation

* Log in to your **Oobeya** account.
* Start to create a new [**AgileSpace analysis**](https://docs.oobeya.io/project-analytics/project-analytics/starting-an-agile-board-analysis).
* During the setup process, you will reach the **State Mapping** step.
* Map each state from Azure DevOps to the corresponding category in Oobeya.

{% hint style="info" %}
This is crucial because all widgets and metrics in Oobeya are generated based on these mapped states.
{% endhint %}

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F2R83jjP38ksJ84bnkxeu%2Fimage.png?alt=media&#x26;token=9c76c712-7505-45b6-86d8-4f3f2881c5ad" alt=""><figcaption><p>AgileSpace state mapping - Oobeya</p></figcaption></figure>

***

## Conclusion

By carefully managing processes and state mappings between Azure DevOps and Oobeya, you can **enhance** the **accuracy of your analytics** and **gain** **deeper insights** into your Azure Boards Scrum projects. Following these best practices ensures that Oobeya's metrics and widgets provide valuable information to improve project management and team performance.