Azure DevOps Confluence Connector main guide

Objective

Provide useful information about Azure DevOps work items, shared queries and other things. The App supports Azure DevOps SaaS and On-Premises offerings.

Confluence Macros

There are two macros:

Azure DevOps for work items

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.

The goal of this macro is to provide rich information about a single Azure Work Item.

Here is an example of how it looks.

Azure DevOps single work item macro examples

Azure DevOps Work Items Query for saved work item 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.

The goal of this macro is to provide rich information about the list of Azure Work Items returned by the Azure DevOps Work Item Query.

Here is an example of how it looks.

Azure DevOps wiki

Please make sure your personal access token (PAT) has the read scope for Wiki.

Using Azure DevOps Confluence Connector, you can embed wiki content.

Create or find the wiki page that you want to embed. Usually, it is a project read-me or something similar.

Afterwards, use the Azure DevOps Wiki macro that brings wiki content from Azure DevOps wiki to Confluence Cloud.

Short Video Demo

Examples

Supported URLs

Below URLs are supported for Azure DevOps Software as a Service and On-Premises offerings.

Currently, the Cloud version of Azure DevOps Confluence Connector supports two types of links:

  • work-item links. Using Azure DevOps macro. For instance, https://dev.azure.com/MoveWorkForward/Superb%20Audi/_workitems/edit/17/

  • saved query links. Using Azure DevOps Work Items Query macro. For example, https://dev.azure.com/MoveWorkForward/Superb Audi/_queries/query/a212f475-487d-4300-9809-7d5a873ba14c/.

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 work items information only.

If you want to support Wiki content rendering you need to configure the personal access token for this.

Connect

Navigate to Settings → Azure DevOps and enter your personal access token.

How to generate personal access token (PAT)

Please follow this official guide from Microsoft.

Potential issues

No valid licence

You see this message when your Confluence instance does not have a valid license for Azure DevOps Confluence Connector. You need to contact your Confluence administrator(s) to solve this issue. The license can be bought or extended via Atlassian Marketplace.

It also can mean that your trial is over, and your organization needs to acquire a license for Azure DevOps Confluence Connector.

No valid token

You see this message when the configuration of Azure DevOps Confluence Connector has some issues. You need to contact your Confluence administrator to solve this issue.

No valid token can happen due to one of the following reasons:

  • your administrator did not configure Azure DevOps Confluence Connector at all. Action: create the token and insert it on the configuration page.

  • the token created has expired. Action: create a new token with the correct permissions and update the configuration.

  • the token does not provide correct permissions to read the required data. Action: create a new access token with the correct permissions and do not use personal resources (like personal Search Queries), but use the shared ones.

Disconnect

Navigate to Settings → Azure DevOps and click Disconnect.

Providing feedback and bug reports

Please contact us via the Service Desk.

Updated: