azure-devops - 备份 VS Team Services 上的工作项

Question

是否可以通过某种方式备份/导出/下载所有工作项？我查看了 REST API，但似乎您无法执行 f.e.通过此 API 进行查询...

Answer 1

好的，找到了完成工作的方法。我再次查看了 API 文档。本页https://www.visualstudio.com/en-us/docs/integrate/api/wit/overview帮助我。你首先需要做一个

GET https://{account}.visualstudio.com/defaultcollection/{project}/_apis/wit/queries/{folderpath}?api-version={version}&$expand=wiql

您需要从生成的 JSON 中获取 wiql 部分，这是实际的查询。在此之后你需要做一个

POST https://{account}.visualstudio.com/defaultcollection/{project}/_apis/wit/wiql?api-version={version}

正文是带有 { "query"= "YOURQUERY"} 的 JSON

因此，您将收到一个包含所有工作项 URL/ID 的 JSON。您需要通过它们并通过查询每个工作项

GET URL?$expand=all

注意:仅当您也需要关系和附件时才添加 ?$expand=all。我为 PowerShell 整合了一些东西。注意:我决定对查询进行硬编码并删除错误处理以使其更短一些。

function loadJsonFile($fileName) 
{
    return ConvertFrom-Json "$(Get-Content $fileName)"
}
function getLastItemFromURL($url) 
{
    $absPath = ([System.Uri]$url).AbsolutePath
    $lastSlash = $absPath.LastIndexOf("/")
    $absPath.Substring($lastSlash+1)
}
function getWorkItemId($url)
{
    getLastItemFromURL($url)
}

# make sure you enabled alternative credentials and access for them
# you can get the value for YOURCODE i.e. via Fiddler
$headers = @{Authorization="Basic YOURCODE"}

# before this you would need to find the WIQL of the query; left to you
$body = @{  
    "query" = "THEQUERYFROMTHEJSON"
}
$bodyJson = $body | ConvertTo-Json

Invoke-RestMethod -method Post -ContentType application/json -Uri "https://{account}.visualstudio.com/defaultcollection/{project}/_apis/wit/wiql?api-version=1.0" -Headers $headers -Body $bodyJson -OutFile workitems.json

$workItemsJson = $(loadJsonFile workitems.json)
$workItems = $(foreach ($relation in $workItemsJson.workItemRelations)
{
    $relation.target.url
    $relation.source.url
}) | select -Unique | sort

echo "Going to download the following ids from $(getWorkItemId $workItems[0])-$(getWorkItemId $workItems[-1])"

# download the workitems
foreach($workItemUrl in $workItems)
{
    $workItemId = getWorkItemId $workItemUrl
    echo "Download ID: $workItemId"

    $workItemUrl = "$workItemUrl`?`$expand=all"
    $fileName = "workitem_$workItemId.json"
    Invoke-RestMethod -ContentType application/json -Uri "$workItemUrl" -Headers $headers -OutFile "$fileName"

    # download attachments
    $workItemJson = $(loadJsonFile "$fileName")
    foreach($relation in $workItemJson.relations)
    {
        if($relation.rel -eq "AttachedFile") 
        {
            $fileUrl = $relation.url
            Invoke-WebRequest $fileUrl -Headers $headers -OutFile $(getLastItemFromURL $fileUrl)
        }
    }
}