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 platforms with OAuth2. 

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

• 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.

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.
  

• 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.

Automatic Import From Azure DevOps

With this tool, your ADO work items will be automatically imported into your Chisel workspace. 

• Toggle the button below ‘Auto Import.’
  
• Once you do so, you must configure ‘Destination’ and ‘Work Items’ as below:
  

1. Under ‘Choose Destination – Product,’ select the Product from your Chisel workspace where you want the imported components to be created.
2. Under ‘Choose Destination – Component,’ select the Epic/Component from your Chisel workspace where you want the imported features to be created.
3. Under ‘Choose Work Item – Import as a Component,’ select the work items (part of the ADO workspace) from the list which you want to be imported as Components in your Chisel workspace.
4. Under ‘Choose Work Item– Import as a Feature,’ Select the work items (part of the ADO workspace) from the list which you want to be imported as Features in your Chisel workspace.

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 link 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 the 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.’

Flat List 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 ‘Work Item Type’ 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 your work items as a Component, Feature, or SubFeature.

• Import as: If you choose to import the work items as a Component, kindly select the Product from your Chisel workspace where you want to create the imported components. Likewise, if you choose Feature, select the component; if you choose a subfeature, select Feature.
  
  
• Click on the ‘Import work items‘ button.

Hierarchy Import

You can import your ADO nested hierarchies (parent/child relationship) (Eg. Epic–>Issue–>Task) into Chisel (Eg. Component–>Feature–>Subfeature) in just a few steps. 

You simply have to select a relevant product under which to import these hierarchical work items. All the while maintaining the hierarchy of parent/child. 

Find out how to go about importing your ADO work items while maintaining the hierarchy.

How to Link Parent/Child Hierarchy?

• Toggling on the button next to ‘Map child items to parent’ organizes your Azure DevOps workspace based on the parent/child hierarchy in Chisel.

Linking the Hierarchy in Treeview

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