在Azure Boards和Azure DevOps中将查询定义为超链接

  • 项目

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

查询超链接使用工作项查询语言 (WIQL) ，类似于 Transact-SQL。 有关构造 WIQL 的详细信息，请参阅 工作项查询语言的语法 (WIQL) 。

注意

大多数浏览器对 URL 字符串强制限制在 2000 到 2083 个字符之间。

重要

Select a version from Azure DevOps Content Version selector.

若要查看可用于你的平台的内容，请确保从目录上方的版本选择器中选择本文的正确版本。 功能支持会有所不同，具体取决于你使用的是 Azure DevOps Services 还是本地版本的 Azure DevOps Server。
若要了解正在使用哪个本地版本，请查看我使用的是哪个平台/版本？

对 URL 语法的 WIQL 部分进行编码。 可以使用任何 URL 编码器工具对 URL 进行编码。

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

例如，以下超链接列出了 fabrikamFiber/Web 区域路径下为 fabrikam 组织定义的所有活动 bug 的 ID 和标题。

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

解码的 WIQL 符合：

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

注意

对于针对Azure Boards进行的查询，WIQL 长度不得超过 32K 个字符。 系统不允许创建或运行超过该长度的查询。

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

例如，以下超链接列出了 FabrikamFiber/Web 区域路径下所有 bug 的 ID、标题和状态。

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

这与下面所示的非编码项相当。

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'