如何检索附加到工作项的 wiki 链接

Question

我正在尝试使用 azure-devops python 包从 Azure DevOps 中提取 wiki 链接。使用 WIQL 这样做可行吗？检索项目到项目的链接可以像这样完成：

        SELECT * FROM workitemLinks 
        WHERE (Source.[System.AreaPath] Under 'devOpsTesting\testArea')
        AND ([System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward')
        AND (Source.[System.Id] = 3)  
        ORDER BY [System.Id]
        MODE (Recursive)

是否有针对 wiki 链接的类似解决方案，如果没有，如何检索它们？

Answer 1

我们无法通过 WIQL 查询列出 wiki links 的作品 links。如果 link 不包含工作项，我们将无法获得我们想要的结果。

作为测试结果，我发现如果我们link wiki to work item，字段External Link Count的值会大于0。

作为解决方法，我们可以使用 REST API 列出所有 External Link Count 大于 0 的工作项。

休息 API

POST https://dev.azure.com/{Org name}/{Project name}/{Team name}/_apis/wit/wiql?api-version=6.0

请求正文：

 {"query": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.TeamProject] = @project and [System.WorkItemType] = 'User Story' AND [External Link Count] > '0' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}

现在，我们可以列出工作项 ID。

结果：

然后我们通过REST API查看工作项的详细信息。

GET https://dev.azure.com/{Org name}/{Project name}/_apis/wit/workitems/{Work item ID}?$expand=all&api-version=6.1-preview.3

我们需要注意字段relations.attributes.name，如果工作项link是wiki，我们可以通过这个字段来检查它。

结果：

更新1

retrieve wiki links attached to a Work Item

通过 REST API 和电源列出工作项 ID shell。

电源shell脚本：

$connectionToken="{PAT}"
$base64AuthInfo= [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$($connectionToken)"))
$WorkItemQueryURL = "https://dev.azure.com/{Org name}/{project}/{team name}/_apis/wit/wiql?api-version=6.0" 

$body =@"
{
  "query": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.TeamProject] = @project and [System.WorkItemType] = 'User Story' AND [External Link Count] > '0' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}
"@
$WorkItem = Invoke-RestMethod -Uri $WorkItemQueryURL -ContentType "application/json" -Body $body -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)} -Method POST

#Write-host $WorkItem.workItems.id



ForEach ($ID in $WorkItem.workItems.id)
{
 
 $WorkItemInfoURL = "https://dev.azure.com/{org name}/{project name}/_apis/wit/workitems/$($ID)?" + "$" + "expand=1&api-version=6.1-preview.3" 
 $WorkItemInfo = Invoke-RestMethod -Uri $WorkItemInfoURL -Headers @{authorization = "Basic $base64AuthInfo"} -Method Get

 #Write-host   $WorkItemInfo.relations.attributes.name

 if ($WorkItemInfo.relations.attributes.name -eq "Wiki Page"){  
  Write-host $ID
 }

}

结果：

更新2

休息API:

GET https://dev.azure.com/{Org name}/{project name}/_apis/wit/workitems/{wok item ID}?$expand=all&api-version=6.1-preview.3

结果：

我们可以通过响应 url link.

获取 wiki 名称

如何检索附加到工作项的 wiki 链接

How to retrieve wiki links attached to a Work Item

python

wiql

azure-devops