Azure DevOps Integration

Azure DevOps Integration

Azure DevOps provides developer services for allowing teams to plan work, collaborate on code development, and build and deploy applications.

As a product manager, you would like to know what is up with the developer services.

If you are already using both Azure DevOps and Chisel, Chisel’s Azure DevOps integration is the perfect tool for you to ensure that work items are synchronized between the two platforms.

Authorizing Azure DevOps with OAuth2

When setting up an integration between Chisel and Azure DevOps, the first step is to authorize the integration between both the platforms with OAuth2

Follow the steps below to authorize the Azure DevOps integration with OAuth2.

  • Head to the integration section under the ‘User Actions’ tab. To do so, click on your name in the top right corner of the screen and click on ‘Integrations.’
  • Once you click on ‘Integrations,’ you will see a screen that shows you all the integrations you have set up and other integrations you can set up.
  • Next, click on the connect button next to Azure DevOps.
  • If you have logged into Azure DevOps, you will come to a screen where you can see all the authorization-related access and Chisel requests for the Azure DevOps Integration. 

Scroll down and kindly accept the authorization by clicking on the ‘Accept’ button. 

  • If you haven’t logged into Azure DevOps, kindly log in and follow the above step.

Now you will be navigated back to your Chisel workspace, where you will configure the integration as per your requirements.

Pro tip: Make sure in ADO you have enabled the ‘Application connection policies tab’ under ‘Organization Settings.’ Toggle on the ‘Third-party application access via OAuth.’

Standard Configurations

Now that you have authorized the integration, you will have to configure the integration. 

Choose Azure DevOps Organization & Project

The first step for configuring the Azure DevOps integration is to choose the correct organization and project from Azure DevOps which you want to integrate with.

Note: Ensure you have created a project in your Azure DevOps workspace.

Once selected, click on Save Project.’

Note: You cannot change the Organization and Project once selected. You will have to create a new integration for a different project.

Two-way sync

Two-way synchronization enables information to flow back and forth between Chisel and Azure DevOps.

To enable two-way sync, kindly enable the toggle below the 2-way Sync.

Parent/Child Hierarchy

Toggle on the ‘Parent/Child hierarchy’ button to organize your Azure DevOps workspace based on your parent/child hierarchy in Chisel.

We will look at how to go about linking the hierarchy in Treeview later in this article.

ADO – Chisel Mappings

The next step in the integration is to map different entities between Azure DevOps and Chisel, as terminology may differ between your Chisel workspace and the Azure DevOps project.

Default Mappings

By default, the name, description, start date, and due date will be mapped automatically.

Status Mappings

For both the status of a work item in the Azure DevOps project and the kanban status of Feature from Chisel to stay in sync with each other, you have to map them. 

For status mapping, you need to map status from Azure DevOps with a kanban status in Chisel.

Label Mappings

The labels you create in Chisel and the tags in Azure DevOps need to map to stay in sync.

For label mapping, you need to map every tag from Azure DevOps with a label in Chisel.

After completing the above steps, kindly verify all the inputs you gave and click on ‘Save Integration.’

One time import

Apart from automatic import, Chisel also allows you to import the work items already in your Azure DevOps project to your Chisel workspace.

Select the ‘Issue Types’ you want to import into the Chisel workspace, rewrite the Azure DevOps Search query if required, and hit the ‘Find Work Items’ button.

The section below will show you all the relevant work items present in your Azure DevOps project.

Now you can choose to Import it as a Feature or as a Component. You can toggle between Feature and Component as per your requirement.

Import as Feature

If you choose to import it as Features, kindly select the ‘Component’ from your Chisel workspace where you want to create the imported features.

Import as Component

If you choose to import it as Components, kindly select the ‘Product’ from your Chisel workspace where you want to create the imported components.

Toggling on the button next to ‘Map child items to parent’ organizes your Azure DevOps workspace based on the parent/child hierarchy in Chisel. For simplicity, Parent/Child in Azure DevOps is synonymous with Component/Feature in Chisel, respectively. 

Turning on the toggle before pushing work items into Azure DevOps is mandatory because Chisel cannot change the parent/child hierarchy once the items get pushed. 

Go to Treeview, Open the component, and link the ADO integration with the project by selecting the ADO WorkItem type. Follow the same process with the feature as well.