Skip to main content

Setting up Azure DevOps integration for NextGen story maps

Learn how you can setup Azure DevOps integration for your story map.

Written by Tamás Párványik

Contents:

StoriesOnBoard & Azure DevOps integration overview

Integrating your story map with an Azure DevOps project allows teams to plan more effectively, utilizing the visual power of story mapping to achieve transparency and shared understanding among stakeholders. Bring the team around to the story map to see the big picture and take advantage of real-time and bidirectional sync with Azure DevOps to keep everyone up to date at all time. The integration makes it possible to plan iterations on the story map and push cards to Azure DevOps for execution and keep your backlog in sync. With the powerful integration between StoriesOnBoard and Azure DevOps you can build and manage amazing products from the very beginning. This allows to do product discovery with user centric approach to build great products that users love.

Who can setup the Azure DevOps integration

You must have Admin role on the story map on StoriesOnBoard to be able to setup the integration with Azure DevOps. On the Azure DevOps side you must hold Admin rights as well.

How to setup Azure DevOps integration on your story map

  1. Open the story map

  2. Go to “Settings“

  3. Select “Integration settings”

  4. Select "Azure DevOps"

  5. Enter your "Organization address"

  6. Complete the authentication

  7. Select your Azure DevOps project that you want to integrate with your story map

  8. Click on "Connect project" then proceed with "Next"

  9. Choose synchronization method

  10. Setup what you want to keep in sync

  11. Setup export settings

  12. Setup import settings and status mapping

  13. Setup release synchronization

  14. Decide about Impersonation

  15. Get started

Step-by-step guide to link your story map to an Azure DevOps project

Open your story map and navigate to "Settings" then select "Integration settings".


Select "Azure DevOps", then click on "Connect".

Connect your Azure DevOps organization by entering the Organization Address.


It should be something like these examples:

Please do not include the project name in the URL.

You will be redirected to authenticate. Upon successful connection, you will be able to select your Azure DevOps project you wish to connect to your story map. Then simple select "Connect" then proceed with "Next".


To complete the integration you must follow steps in the integration wizard.
​
First, you need to decide on the hierarchy of the integration:

  • Link all levels of the board hierarchy (Epic, Feature, Story)

  • Link the second and the story level of board hierarchy (Feature, Story)

  • Link only story level cards.

Keep your cards in sync:

Choose the export area then click "Next".

Setup the status mapping between the story map and the Azure DevOps project.

Setup release synchronization and select the parent iteration for exported releases. The map's releases will be synced to iterations in Azure DevOps.

Decide about impersonation and complete the setup.

How to access integration settings

StoriesOnBoard currently provides two interfaces to manage your story maps. These are the Classic and NextGen story map interfaces. Currently, you can only access integration settings for Azure DevOps if you navigate to Classic.

Integration settings on NextGen interface

Troubleshooting

In case you receive the error message below when you try to connect Azure DevOps, you need to change your settings in order to make this work.

If you receive the error message below these are the following things you need to check:

  • Not valid Azure DevOps workspace URL (do not include the project name)

  • OAuth issue (Third-party application access via OAuth is disabled)

  • Not holding the right access level (you are not a project admin)

  • You are a project admin but you do not have the rights (enable Edit project level info and View project level)

To resolve this issue, open your Azure DevOps and visit Organization Settings go to Security and select Policies. Make sure that Third-party application access via OAuth is enabled.
​

To resolve user rights issue, open your Azure DevOps and visit Project Settings > Permissions and select Project Administrators. Then enable "Edit project level info" and "View project level".


Learn more about:

Did this answer your question?