Azure DevOps Integration
An overview of the Azure DevOps data integration
Overview
The Azure DevOps integration updates your goal progress automatically based on work items in Azure DevOps.
The Azure DevOps integration is available for customers on the Pro and Enterprise plans.
How to set up the integration
Account admins can enable the Azure DevOps integration by following these steps:
- Access Integrations: Go to your Mooncamp workspace settings and open the Integrations section.
- Enable Azure DevOps: Find Azure DevOps and toggle the integration on.
- Connect to Azure DevOps: Any user with sufficient permissions and access to Azure DevOps can then sign in with their Microsoft account and grant access to Azure DevOps. Once authorized, users that have access to the connection can link their Mooncamp goals with their work items in Azure DevOps.
Using Azure DevOps for tracking goals
To automatically track progress for a goal using Azure DevOps, follow these steps:
- Create or edit a goal: Go to the Progress property and choose a measurement type that allows connecting to a data source.
- Select Automatic Progress Tracking: Click Connect to data source and select Azure DevOps from the list of available integrations.
- Tracking Progress: First, select an organization and a project. Then, select a query or a set of work items to track progress.
There are two options for selecting work items to track progress: Shared Query (tracking work items from an existing query from Azure DevOps) and Work items (tracking a specific set of work items and all their children).
- Save your connection: After configuring your tracking settings, click Save. The Azure DevOps icon will appear next to your goal, indicating it’s synced with Azure DevOps.
Tracking options
Below is a table of the different options for tracking progress and the metrics that can be used.
| Track Progress By | Percentage metric | Number metric |
|---|---|---|
| Count of Work Items | Percent of completed work items out of the total work items for the given query or work item type. | Number of work items for the given query or work item type. |
| Story Points | Percent of story points for the completed work items out of the total story points for the work items for given query or work item type. | Sum of story points for the work items for given query or work item type. |
| Effort | Percent of effort for the completed work items out of the total effort for the work items for given query or work item type. | Sum of effort for the work items for given query or work item type. |
| Original Estimate | Percent of total original estimate hours for the completed work items out of the total original estimate hours for all the work items for given query or work item type. | Sum of original estimate hours for the work items for given query or work item type. |
| Remaining Work | N/A | Total remaining work hours for the work items for given query or work item type. |
| Completed Work | Percent of total completed work hours for the completed work items out of the total completed work hours for all work items for the given query or work item type. | Total completed work hours for the work items for given query or work item type. |
Automatic Progress Updates
Once the integration is active, Mooncamp automatically updates your goals based on changes in Azure DevOps.
Tip for admins: Go to Settings > Integrations, and make sure every day is selected under Synchronization.