Contents:
StoriesOnBoard & Microsoft Team Foundation Server integration overview
Integrating your story map with an Azure DevOps (TFS) 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 (TFS) 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 (TFS) for execution and keep your backlog in sync. With the powerful integration between StoriesOnBoard and Azure DevOps (TFS) 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 Microsoft Team Foundation Server 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 Microsoft Team Foundation Server integration on your story map
Open the story map
Go to “Settings“
Select “Integration settings”
Select "TFS"
Proceed with "Go to Integration Settings in Classic view"
Select "Team Foundation Server" option
Enter your "Azure DevOps account URL"
Enter your "Personal access token"
Complete the authentication
Select your Azure DevOps project that you want to integrate with your story map
Save changes
Step-by-step guide to setup Microsoft Team Foundation Server integration
Open your story map and navigate to "Settings" then select "Integration settings".
Select "TFS", then click on "Integration Settings". We will redirect you to our Classic interface to setup the integration. Once it is done, you can return to the NextGen interface.
Select "Team Foundation Server" as a tool to integrate with.
Enter your "TFS server collection URL" and your "Personal Access Token". Then proceed with "Connect".
Your TFS server collection URL should be something like these examples:
💡 Tip - Learn more about How to create your TFS Personal Access Token
Upon successful connection, you will be able to select your project you wish to connect to your story map. Then simple select "Link project".
To complete the integration "Save" your settings.
💡 Tip - Learn How to customize your integration with Azure DevOps
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 Classic interface
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 got o 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: