Setting up an Azure Devops Integration

← Back to Azure Devops section

Setting up a Azure Devops Integration

ProdPad has a direct integration available with Azure Devops (formerly known as Visual Studio Team Services/VSTS).

The two-way integration between Azure Devops and ProdPad allows you to push any idea from ProdPad to Azure Devops, creating a link between the idea and the new ticket. You can map your issue statuses in Azure Devops with the custom statuses in ProdPad, and so when the status is updated in Azure Devops, the change reflects in your ProdPad account where the rest of the team can see it.

Getting the integration with Azure Devops set up is easy, and just requires you to follow these steps:

Part 1. Setting up an Azure Devops integration
Part 2. Mapping Fields
Part 3. Pushing ideas to Azure Devops
Part 4. Sharing with your team

Part 1. Setting up the Azure Devops integration in ProdPad

To start, log in to ProdPad as an Admin, and head to the Integrations page.

On the module page, click on +Create Integration and select Azure Devops to get started.

Enter a name for the integration e.g. ADO Dev Queue and and a quick description, then click Create.

If you aren't already logged into Azure Devops, you will be prompted to enter your credentials. Once you're logged into Azure Devops you’ll be prompted to allow ProdPad limited access to your Azure Devops profile. We require access to read your organizations and boards; create and update cards, lists and boards; and make comments on your ideas.

You should ensure your Organization settings are set to accept third party applications via OAuth. You can read more about this here.

Part 2. Mapping fields

Once the authorization is complete, you will be able to select a project from your Azure Devops account. Select the project you want your ProdPad ideas to appear in once they've been pushed to Azure Devops.

Next, it's time to map your fields from ProdPad to Azure Devops.

In this step, you'll pick which fields from your Ideas page you want to send to Azure Devops. At the very least, you need to select something for the Name field in Azure Devops – we recommend using the Title field from your ProdPad idea for this. You can also pre-fill the Description in your Azure Devops issue with the description, business case and functional specs in ProdPad, or any combination of them.

Finally, you can set your field mapping to include mockups and files from ProdPad, which will be added as Attachments to your new card in Azure Devops, once you push.

The last step is to map statuses, so that as the issue moves within the development workflow, ProdPad will reflect those changes.

To ensure your field selections have been saved, make sure to check that you've scrolled down and clicked the ' Save changes' button for each field. 

Part 3. Pushing ideas to Azure Devops

Now that you've got an active integration with Azure Devops set up, it's time to start pushing finished ideas from ProdPad to Azure Devops.

Head to your Ideas List, and pick an idea that's ready for development. In the Idea Canvas page, click on  Push to development at the top right. This will open up a modal window where you can choose to push the Idea via the Azure Devops integration you've set up, or any of your other integrations.

Once pushed to Azure Devops, your ProdPad statuses will sync with your Azure Devops statuses as they are updated. (Note: the update cycles every 20 minutes, you should not have to wait longer than that to see this in ProdPad).

Part 4. Sharing with your team

To make it easy for your team to use the same integration mappings, you can share your integration with your team.

In your Integrations list, click the 'Teamwide' setting.

Once this is done, anyone in your ProdPad account can log in and go to the Integrations & API page, and select the original integration in the 'Available Integrations' list.