Please make sure your organization permits OAuth for APIs.

https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/change-application-access-policies?view=azure-devops

Short video demo - https://www.youtube.com/watch?v=dQ_vEVMrbrs

Objective

Azure DevOps Confluence Connector provides useful information on the Confluence page about Azure DevOps Work Items, Azure DevOps Queries and Azure DevOps pipeline build status.

Support Functionality

  • Provide rich information about Azure DevOps work items on the Confluence page.

  • Provide rich information about the results of Azure DevOps saved search queries. You can also display only the result item count or the top N items.

  • Provide near real-time information about Azure DevOps pipeline status.

  • Allow shown data configuration for work item-related macro.

Short Video Demo

Short video demo - https://www.youtube.com/watch?v=dQ_vEVMrbrs

The latest version of Azure DevOps Confluence Connector supports the following macro:

  • Azure DevOps pipeline build status link

  • Azure DevOps saved search query

  • Azure DevOps search for work items

  • Azure DevOps a single work item

Macro examples and additional settings

Work items

You can insert the macro from the macro browser and configure visible fields (available since 1.19.26).

Search queries

You need to make sure the Query/Work Item/Project can be accessed by the user who created the personal access token. See here how to make shared queries.

You can use the query link and parameterize the results.

You can copy the URL from a couple of places:

  1. From the queries list.

2. When the query is opened you can copy the URL.

When you insert the macro you can configure the visible fields and the amount of items visible (since 1.19.26 version).

The result may look like this.

Since version 1.19.26 you can configure the visible fields.

Azure DevOps pipeline

Copy the link to the pipeline definition like the one below.

Paste into the Confluence page and observe the pipeline status.

Configuration

Getting the personal access token

You need to navigate to the Personal Access Tokens page in Azure DevOps.

Create a new personal access token with minimal scope. Currently, the App needs the token to read-only work items information and read-only access to the builds.

Connect

Navigate to System → Azure DevOps and enter your personal access token. If the token has expired you need to create a new one and enter it here again.

Setup Azure DevOps base URL and organization name

Using global settings you can set up the base URL and organization name to not enter them in the macro.

How to generate personal access token (PAT)

Please follow this official guide from Microsoft.

Disconnect

Navigate to System → Azure DevOps and click Disconnect.

Troubleshooting

How to get debug logs for the Azure DevOps links App

Enable the debug mode for the namespace com.moveworkforward

Here is the video on how to do this - https://www.loom.com/share/dbee646231ef4306b15cb6617cdee8cd

Updated: