Skip to main content
Skip table of contents

How to create and configure an Azure DevOps Query Link macro?

By embedding query links within Confluence pages, you can provide contextual documentation and references. This enables team members to quickly view and collaborate on the same set of query results and saves time and simplifies the process of finding and accessing relevant query data.

Create Azure DevOps Query Link macro

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.

We provide 2 convenient ways to create the Azure DevOps Query Link macro:

  1. Copy and Paste a link to Azure DevOps entities to the Confluence page directly.

  2. Use the editor menu on the top (click on the + button) to reach the Azure DevOps Query Link macro. To make your search easier type the first letters of the macro name.

You can copy the query URL from a couple of places:

  • from the queries list:

  • from the location bar of your browser when the query is opened:

Example of links to Query

CODE
https://dev.azure.com/MoveWorkForward/Driverless%20Porsche/_queries/query/a72adfc2-aedb-4d9a-b76a-ab8cdfd8a501/

Macro configuration

  1. Enter the link to the Azure DevOps work items query in the macro modal window.

  2. The preview option allows you to verify and validate the macro view before actually inserting the macro into your Confluence page.

  3. Parameterise the results by configuring:

    1. the visible fields;

    2. the number of visible items (in the Fields section’s drop-down are rendered fields based on the organization indicated in work item Url);

    3. hide/show header;

    4. amount of rows to display in a table.

4. Click on the Safe button to insert the macro into your Confluence page.

The feature of changing the number of visible items is available since 1.19.26

The feature which allows hide/show header is available since 1.20.20

View on the Confluence page

Updated:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.