You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/boards/queries/about-managed-queries.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ ms.topic: conceptual
9
9
ms.author: chcomley
10
10
author: chcomley
11
11
monikerRange: '<= azure-devops'
12
-
ms.date: 10/08/2025
12
+
ms.date: 10/27/2025
13
13
ai-usage: ai-assisted
14
14
---
15
15
@@ -33,7 +33,7 @@ You can create queries and query folders from the web portal or Visual Studio Te
33
33
If you're getting started, read [View, run, or email a work item query](view-run-query.md). For a quick reference to query editor tasks and sample queries, see [Query quick reference](query-index-quick-ref.md).
34
34
35
35
- To find work items assigned to you, use the **@Me** macro as the value for the **Assigned To** field in a clause.
36
-
- All valid users with standard access can create queries and folders under **My Queries**. To create queries or folders under **Shared Queries**, set the Contribute permission. See [Set permissions on queries](../queries/set-query-permissions.md).
36
+
- All valid users with standard access can create queries and folders under **My Queries**. To create queries or folders under **Shared Queries**, you must have the Contribute permission. See [Set permissions on queries](../queries/set-query-permissions.md).
37
37
- Modify any query by adding criteria to focus on a product area, an iteration, or another field. To modify a query, [open the query editor](using-queries.md).
38
38
- Open any query in [Excel](../backlogs/office/bulk-add-modify-work-items-excel.md) to update fields and publish changes to the database.
39
39
- Visualize status or progress by creating a pie, column, or trend chart for flat-list queries. For details, see [Charts](../../report/dashboards/charts.md).
@@ -56,7 +56,7 @@ The following sections summarize functions you use to define and manage work ite
56
56
57
57
### Unsupported features
58
58
59
-
Queries only support work items and work items linked to other work items. Managed queries do not support:
59
+
Queries only support work items and work items linked to other work items. Managed queries don't support:
60
60
61
61
- Hierarchical views of Test Plans, Test Suites, and Test Cases (these items don't use parent-child links). Instead, view the hierarchy through the Test > Test Plans page.
62
62
- Views that show linked objects such as builds, releases, code, or other non-work-item objects.
@@ -104,7 +104,7 @@ Azure Boards supports three query types; the icon next to a query indicates its
104
104
- Triage linked work items, including test-related links
105
105
- Find orphaned backlog items (items with no parent)
106
106
> [!NOTE]
107
-
> **Work items and direct links** queries export to Excel as a flat list. Excel imports them as a flat list because modifying multiple link types in Excel isn't supported.
107
+
> **Work items and direct links** queries export to Excel as a flat list. Excel imports them as a flat list because Excel doesn't support modifying multiple link types.
108
108
:::column-end:::
109
109
:::row-end:::
110
110
---
@@ -125,7 +125,7 @@ To learn more about link types, see [Link type reference](link-type-reference.md
125
125
126
126
## My Queries, Shared Queries, and Favorites
127
127
128
-
You alone can view and run queries saved under **My Queries**. Favorite a query to have it appear in your query selector.
128
+
Only you can view and run queries saved under **My Queries**. Favorite a query to have it appear in your query selector.
129
129
130
130
Queries saved under **Shared Queries** are visible to everyone with project access. Organize shared queries in folders and favorite them for quick access. You can set permissions on folders and queries to prevent others from moving or editing them.
131
131
@@ -196,7 +196,7 @@ If taskboard contents differ from a created query's results, see [Taskboard item
196
196
197
197
## Full-text search queries and collation settings
198
198
199
-
If you use full-text search queries with the **Contains** or **Contains Words** operators, ensure SQL Server collation corresponds to a language with a registered word breaker. Unsupported languages can yield unexpected results.
199
+
If you use full-text search queries with the **Contains** or **Contains Words** operators, ensure that SQL Server collation corresponds to a language with a registered word breaker. Unsupported languages can yield unexpected results.
Copy file name to clipboardExpand all lines: docs/boards/queries/linking-attachments.md
+22-22Lines changed: 22 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ author: chcomley
10
10
ms.topic: example-scenario
11
11
ai-usage: ai-assisted
12
12
monikerRange: '<= azure-devops'
13
-
ms.date: 10/09/2025
13
+
ms.date: 10/27/2025
14
14
---
15
15
16
16
# Query work items by link or attachment count
@@ -69,7 +69,7 @@ Create a query and select **Tree of work items** to begin. The Query Editor show
69
69
70
70
***
71
71
> [!NOTE]
72
-
> You can't construct a query that shows a hierarchical view of Test Plans, Test Suites, and Test Cases because those items aren't linked together using parent-child link types. Use a direct links query to list test-related work items, or view the hierarchy on the Test Plans page.
72
+
> You can't construct a query that shows a hierarchical view of Test Plans, Test Suites, and Test Cases because those items don't link together using parent-child link types. Use a direct links query to list test-related work items, or view the hierarchy on the Test Plans page.
73
73
74
74
## Options for filters and query clauses
75
75
@@ -129,13 +129,13 @@ The following example shows a dependent linked query that returns items with dep
129
129
130
130
#### [Browser](#tab/browser/)
131
131
132
-
The following query finds work items in all projects that are linked to work items under the **Fabrikam** area path and project using Predecessor and Successor link types.
132
+
The following query finds work items in all projects that link to work items under the **Fabrikam** area path and project using Predecessor and Successor link types.
133
133
134
134
:::image type="content" source="media/link-attachments/direct-links-query-web-portal.png" alt-text="Screenshot that shows a direct links query in the web portal.":::
135
135
136
136
- Select **Query across projects** to include dependent linked work items from other projects.
137
-
- Add the **Area Path Under Fabrikam** clause to filter for work items that are linked to items defined under the Fabrikam project.
138
-
-Choose**Only return items that have matching links**, and then choose**Return selected link types** to return only work items linked as **Predecessor** or **Successor**.
137
+
- Add the **Area Path Under Fabrikam** clause to filter for work items that link to items defined under the Fabrikam project.
138
+
-Select**Only return items that have matching links**, and then select**Return selected link types** to return only work items linked as **Predecessor** or **Successor**.
139
139
140
140
141
141
#### [Visual Studio 2015](#tab/visual-studio/)
@@ -147,8 +147,8 @@ Use this query to list dependent work items that link to active Product Backlog
147
147
- Remove the **Team Project = @Project** clause to enable results from all projects in the collection.
148
148
- Group the two clauses that select **Product Backlog Item**s and **Bug**s to return work items that match either filter.
149
149
- When you group the two clauses, start the second group with the **OR** operator to return work items that match either of the grouped clauses.
150
-
-Choose**Only return items that have the specified links** to return top-level work items that have dependencies.
151
-
-Choose**Return links of any type** to return all linked work items that match the linked-item filter criteria.
150
+
-Select**Only return items that have the specified links** to return top-level work items that have dependencies.
151
+
-Select**Return links of any type** to return all linked work items that match the linked-item filter criteria.
152
152
153
153
The following image shows the query results.
154
154
@@ -185,7 +185,7 @@ The following table describes fields associated with links and attachments. Most
185
185
The number of files attached to the work item and stored in the work item tracking database.
> For Azure Boards (cloud service), you can add up to 100 attachments to a work item. Attempts to add more results in an error message when you save the work item.
188
+
> For Azure Boards (cloud service), you can add up to 100 attachments to a work item. Attempts to add more result in an error message when you save the work item.
189
189
:::column-end:::
190
190
:::row-end:::
191
191
:::row:::
@@ -227,7 +227,7 @@ The following table describes fields associated with links and attachments. Most
227
227
**Link Comment**
228
228
:::column-end:::
229
229
:::column span="3":::
230
-
Contains comments from the team member who created the link. You can configure this field to appear as a column in a list of links on a work item form. (Not supported in the Query Editor.)
230
+
Contains comments from the team member who created the link. You can configure this field to appear as a column in a list of links on a work item form. (The Query Editor doesn't support this field.)
@@ -239,7 +239,7 @@ The following table describes fields associated with links and attachments. Most
239
239
240
240
:::column-end:::
241
241
:::column span="3":::
242
-
Contains the work item type, ID, and title of the work item that is the target of the link. You can configure this field to appear as a column in a list of links on a work item form. (Not supported in the Query Editor.)
242
+
Contains the work item type, ID, and title of the work item that is the target of the link. You can configure this field to appear as a column in a list of links on a work item form. (The Query Editor doesn't support this field.)
@@ -253,7 +253,7 @@ The following table describes fields associated with links and attachments. Most
253
253
254
254
:::column-end:::
255
255
:::column span="3":::
256
-
When included as a column option in a backlog or query results list, the **Title** of the parent work item is displayed. Internally, the system stores the **ID** of the work item in an Integer field.
256
+
When included as a column option in a backlog or query results list, the system displays the **Title** of the parent work item. Internally, the system stores the **ID** of the work item in an Integer field.
257
257
> [!NOTE]
258
258
> You can add the **Parent** field as a column or specify it within a query clause by specifying the parent work item ID.
@@ -269,7 +269,7 @@ The following table describes fields associated with links and attachments. Most
269
269
270
270
:::column-end:::
271
271
:::column span="3":::
272
-
When included as a column option in a backlog or query results list, the **Title** of the parent work item is displayed. Internally, the system stores the **ID** of the work item in an Integer field.
272
+
When included as a column option in a backlog or query results list, the system displays the **Title** of the parent work item. Internally, the system stores the **ID** of the work item in an Integer field.
273
273
> [!NOTE]
274
274
> The **Parent** field is available from Azure DevOps Server 2020 and later versions. You can't specify this field within a query clause.
-[Query fields, operators, and macros](query-operators-variables.md)
311
-
-[Work item field index](../work-items/guidance/work-item-field.md)
312
-
313
304
::: moniker range="< azure-devops"
314
305
315
306
### Visualize related work and other objects
@@ -320,10 +311,19 @@ View related work items and objects within a work item by using the [Work item v
320
311
321
312
To add link types, see [Manage link types [witadmin]](/previous-versions/azure/devops/reference/witadmin/manage-link-types).
322
313
323
-
All tabs that support creating links between work items use the **LinksControl** element on the work item form. This element controls filtering and restricting the types of work items to which you can link. It also controls the types of links you can create and whether you can link work items in another project. To customize the link controls and restrictions, modify the definition of the `LinksControlOptions` for a work item type; see [LinksControlOptions XML elements](/previous-versions/azure/devops/reference/xml/linkscontroloptions-xml-elements?view=tfs-2017&preserve-view=true).
314
+
All tabs that support creating links between work items use the **LinksControl** element on the work item form. This element controls filtering and restricts the types of work items to which you can link. It also controls the types of links you can create and whether you can link work items in another project. To customize the link controls and restrictions, modify the definition of the `LinksControlOptions` for a work item type; see [LinksControlOptions XML elements](/previous-versions/azure/devops/reference/xml/linkscontroloptions-xml-elements?view=tfs-2017&preserve-view=true).
324
315
325
316
### Default data fields in lists of links
326
317
327
318
You can add or remove columns from the list of links, and you can customize the default columns and the column order. For more information, see [LinksControlOptions XML elements](/previous-versions/azure/devops/reference/xml/linkscontroloptions-xml-elements?view=tfs-2017&preserve-view=true).
328
319
329
320
::: moniker-end
321
+
322
+
## Related content
323
+
324
+
-[Add a link to multiple work items](../backlogs/add-link.md)
325
+
-[Link work items to other objects](../backlogs/add-link.md)
0 commit comments