Our Azure DevOps integration allows your team to transition seamlessly from product discovery to product delivery. There are a few common scenarios you may encounter while configuring this integration. If you encounter a scenario which isn't listed below, please don't hesitate to reach out to our Support team.
In this article:
Partially valid token status
If you see "Partially valid: Data synchronization from Azure DevOps to Productboard won't work." below your Token Status, this means your integration is working but certain functionality in your integration will be limited (e.g. no status synchronization).
There are two situations in which this error can happen:
1) The Azure DevOps administrator who created the token does not have a high enough access.
What went wrong: The administrator who created the integration using his personal access token is not part of the "Project Collection Service Accounts" or "Project Collection Administrators" group.
How to solve it: Ask your Azure DevOps Administrator to include the administrator who created this integration in the "Project Collection Service Accounts" or "Project Collection Administrators" group.
See Microsoft documentation about permissions in Azure DevOps here.
2) The Read & Write Access for the Notifications has not been checked.
What went wrong: The administrator who created the integration using his personal access token forgot to give a Read & Write permission for Notifications. In this case, the status synchronization is not going to work because the Notification permission read & write access was not checked. Therefore, Productboard is unable to update it.
How to solve it: The administrator who created and set up the integration has to go to his personal access token and check the Read & Write Access for the Notifications.
Invalid token status
If you see "Invalid" below your Token Status, this means your Productboard <> Azure DevOps integration will not work.
There are three situations in which this error can happen:
1) Your token has expired
What went wrong: The maximum expiration length of the personal access token is one year. Therefore, the token has expired and your administrator needs to extend it.
How to solve it:
1. Go to your personal access token settings
2. Click edit on the Productboard <> Azure DevOps integration token
3. Click on the calendar and extended it by another year.
2) The required access has not been checked
What went wrong: If the Read & Write access for Work items has not been checked, Productboad is not going to be able to make any modifications.
How to solve it:
1. Log in as an administrator of that personal access token
2. Go to your personal access token settings
3. Click on Read & Write access for Work Items and Notifications
3) Something mysterious...let us help!
What went wrong: If none of the resolution above works, then the issue can be either on the Azure DevOps side or on the Productboard side.
How to solve it: In this case, reach out to our customer support who will help identify the issue and escalate it to the appropriate teams.