Skip to content

Commit a836b34

Browse files
Merge pull request #8469 from MicrosoftDocs/users/chcomley/stale-boards-10-24-2025
Refresh stale Boards/queries
2 parents f258631 + ac49604 commit a836b34

File tree

7 files changed

+161
-166
lines changed

7 files changed

+161
-166
lines changed

docs/boards/queries/about-managed-queries.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: conceptual
99
ms.author: chcomley
1010
author: chcomley
1111
monikerRange: '<= azure-devops'
12-
ms.date: 10/08/2025
12+
ms.date: 10/27/2025
1313
ai-usage: ai-assisted
1414
---
1515

@@ -33,7 +33,7 @@ You can create queries and query folders from the web portal or Visual Studio Te
3333
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).
3434

3535
- 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).
3737
- 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).
3838
- Open any query in [Excel](../backlogs/office/bulk-add-modify-work-items-excel.md) to update fields and publish changes to the database.
3939
- 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
5656

5757
### Unsupported features
5858

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:
6060

6161
- 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.
6262
- 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
104104
- Triage linked work items, including test-related links
105105
- Find orphaned backlog items (items with no parent)
106106
> [!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.
108108
:::column-end:::
109109
:::row-end:::
110110
---
@@ -125,7 +125,7 @@ To learn more about link types, see [Link type reference](link-type-reference.md
125125

126126
## My Queries, Shared Queries, and Favorites
127127

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.
129129

130130
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.
131131

@@ -196,7 +196,7 @@ If taskboard contents differ from a created query's results, see [Taskboard item
196196

197197
## Full-text search queries and collation settings
198198

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.
200200

201201
For more information, see:
202202
- [sys.fulltext\_languages (Transact-SQL)](/sql/relational-databases/system-catalog-views/sys-fulltext-languages-transact-sql)

docs/boards/queries/linking-attachments.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ author: chcomley
1010
ms.topic: example-scenario
1111
ai-usage: ai-assisted
1212
monikerRange: '<= azure-devops'
13-
ms.date: 10/09/2025
13+
ms.date: 10/27/2025
1414
---
1515

1616
# 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
6969

7070
***
7171
> [!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.
7373
7474
## Options for filters and query clauses
7575

@@ -129,13 +129,13 @@ The following example shows a dependent linked query that returns items with dep
129129

130130
#### [Browser](#tab/browser/)
131131

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.
133133

134134
:::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.":::
135135

136136
- 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**.
139139

140140

141141
#### [Visual Studio 2015](#tab/visual-studio/)
@@ -147,8 +147,8 @@ Use this query to list dependent work items that link to active Product Backlog
147147
- Remove the **Team Project = @Project** clause to enable results from all projects in the collection.
148148
- Group the two clauses that select **Product Backlog Item**s and **Bug**s to return work items that match either filter.
149149
- 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.
152152

153153
The following image shows the query results.
154154

@@ -185,7 +185,7 @@ The following table describes fields associated with links and attachments. Most
185185
The number of files attached to the work item and stored in the work item tracking database.
186186
**Reference Name**=`System.AttachedFileCount`, **Data type**=Integer
187187
> [!NOTE]
188-
> 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.
189189
:::column-end:::
190190
:::row-end:::
191191
:::row:::
@@ -227,7 +227,7 @@ The following table describes fields associated with links and attachments. Most
227227
**Link Comment**
228228
:::column-end:::
229229
:::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.)
231231

232232
**Reference Name**=`System.Links.Comment`, **Data type**=PlainText
233233
:::column-end:::
@@ -239,7 +239,7 @@ The following table describes fields associated with links and attachments. Most
239239

240240
:::column-end:::
241241
:::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.)
243243

244244
**Reference Name**=`System.Links.Description`, **Data type**=PlainText
245245
:::column-end:::
@@ -253,7 +253,7 @@ The following table describes fields associated with links and attachments. Most
253253

254254
:::column-end:::
255255
:::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.
257257
> [!NOTE]
258258
> You can add the **Parent** field as a column or specify it within a query clause by specifying the parent work item ID.
259259
**Reference Name**=`System.Parent`, **Data type**=Integer
@@ -269,7 +269,7 @@ The following table describes fields associated with links and attachments. Most
269269

270270
:::column-end:::
271271
:::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.
273273
> [!NOTE]
274274
> The **Parent** field is available from Azure DevOps Server 2020 and later versions. You can't specify this field within a query clause.
275275
**Reference Name**=`System.Parent`, **Data type**=Integer
@@ -301,15 +301,6 @@ The following table describes fields associated with links and attachments. Most
301301
:::column-end:::
302302
:::row-end:::
303303

304-
## Related content
305-
306-
- [Add a link to multiple work items](../backlogs/add-link.md)
307-
- [Link work items to other objects](../backlogs/add-link.md)
308-
- [Query quick reference](query-index-quick-ref.md)
309-
- [Query editor](using-queries.md)
310-
- [Query fields, operators, and macros](query-operators-variables.md)
311-
- [Work item field index](../work-items/guidance/work-item-field.md)
312-
313304
::: moniker range="< azure-devops"
314305

315306
### 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
320311

321312
To add link types, see [Manage link types [witadmin]](/previous-versions/azure/devops/reference/witadmin/manage-link-types).
322313

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).
324315

325316
### Default data fields in lists of links
326317

327318
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).
328319

329320
::: 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)
326+
- [Query quick reference](query-index-quick-ref.md)
327+
- [Query editor](using-queries.md)
328+
- [Query fields, operators, and macros](query-operators-variables.md)
329+
- [Work item field index](../work-items/guidance/work-item-field.md)

0 commit comments

Comments
 (0)