Get started guide for the Confluence end user
Get started guide for the end user of Microsoft Azure DevOps Confluence Cloud integration
Make sure the application is configured by your Confluence administrator first.
Connect Azure DevOps account
Confluence users can set up the integration for their personal needs and connect Azure DevOps account within the personal configuration page. This will allow you to view and embed Azure DevOps macros on Confluence pages.
More information can be found here: How to connect personal Azure DevOps account for integration setup?
Macros usage
Microsoft Teams Azure DevOps Confluence Cloud integration support Azure DevOps instances in the cloud (dev.azure.com) and in your premises. For your instances, you must make sure they are accessible from the Internet.
Your Confluence administrator must add the domain used into the allowed domains on the Azure DevOps configuration page.
Microsoft Azure DevOps Confluence supports the following macro:
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 display only the result item count or the top N items.
Allow shown data configuration for work item-related macro.
There are 3 macros available:
Short Video Demo
Short video demo - https://www.youtube.com/watch?v=IgEx6wSSL1E
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.
This macro aims 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.
This macro aims to provide rich information about the 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 readme or something similar.
Afterwards, use the Azure DevOps Wiki macro that brings wiki content from Azure DevOps wiki to Confluence Cloud.
Use cases
Please follow the use cases section for more details examples.
Examples
Integrate Azure DevOps with Jira
If you are looking at how to bring Azure DevOps commits, builds, branches and deployment information to the Jira issue screen - check out Azure DevOps for Jira Atlassian Marketplace application.
Updated: