Использование патча VsConnection WorkItemTrackingHttpClient для добавления родительского отношения через клиентский API VSTS

Я пытаюсь программно добавить отношения родитель-потомок между двумя рабочими элементами. Я использую библиотеки Microsoft Team Foundation и Visual Studio Services для экспорта и импорта объектов невыполненной работы TFS 2015 и VSTS.

https://docs.microsoft.com/en-us/vsts/integrate/concepts/dotnet-client-libraries

https://www.visualstudio.com/en-us/docs/integrate/api/wit/samples#migrating-work-items

Я работал над получением соединения VssConnection с моими серверами и получением WorkItemTrackingHttpClient для выполнения запросов Wiql и создания рабочих элементов. У меня также есть запрос на определение родителя целевого рабочего элемента.

Я не могу понять, как добавить связь между дочерними рабочими элементами и их родителями. Я не знаю правильный путь к элементу JsonPatchDocument для добавления родительского элемента или правильное свойство или метод для существующего WorkItem, чтобы обновить его с помощью родительской ссылки. Есть ли у кого-нибудь ссылки на документацию или конкретную информацию о добавлении родительских отношений к рабочему элементу с использованием этих библиотек?

Вот несколько фрагментов кода для контекста:

using Microsoft.TeamFoundation.Core.WebApi;
using Microsoft.TeamFoundation.WorkItemTracking.WebApi;
using Microsoft.TeamFoundation.WorkItemTracking.WebApi.Models;
using Microsoft.VisualStudio.Services.Client;
using Microsoft.VisualStudio.Services.WebApi;
using Microsoft.VisualStudio.Services.WebApi.Patch;
using Microsoft.VisualStudio.Services.WebApi.Patch.Json;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
// ...
var sourceConnection = new VssConnection(new Uri(_sourceTsUrl), new VssClientCredentials());
var targetConnection = new VssConnection(new Uri(_targetTsUrl), new VssClientCredentials());
var sourceClient = sourceConnection.GetClient<WorkItemTrackingHttpClient>();
var targetClient = targetConnection.GetClient<WorkItemTrackingHttpClient>();
// ...
var queryResults = sourceClient.QueryByWiqlAsync(query).Result;
var ids = queryResults.WorkItems.Select(x => x.Id).ToList();
var items = sourceClient.GetWorkItemsAsync(ids);
foreach (var item in items.Result)
{
    // ...
    var patchItem = new JsonPatchDocument();
    foreach (var fieldName in item.Fields.Keys)
    { patchItem.Add(new JsonPatchOperation() { Path = $"/fields/{fieldName}", Value = item.Fields[fieldName], Operation = Operation.Add }); }
    // TODO - add patch field(?) for parent relationship
    var parentResults = sourceClient.QueryByWiqlAsync(parentQuery).Result;
    // ...
    var task = targetClient.CreateWorkItemAsync(patchItem, targetProject, itemType, validateOnly, bypassRules, suppressNotifications);
    var newItem = task.Result;
    // TODO - alternatively, add parent via the returned newly generated WorkItem
}

Добавление: я попытался добавить следующий код, но изменения не фиксируются на удаленном объекте, он существует только в локальной памяти, и я не могу найти метод для отправки изменений / обновлений.

if (!string.IsNullOrWhiteSpace(mappedParentUrl))
{
    if (newItem.Relations == null)
    { newItem.Relations = new List<WorkItemRelation>(); }
    newItem.Relations.Add(new WorkItemRelation() { Rel = "Parent", Title = mappedParentTitle, Url = mappedParentUrl });
}

tfs azure-devops c# azure-devops-rest-api json-patch
person Ross    schedule 09.01.2018    source источник

Ответы (1)


arrow_upward
11
arrow_downward

Обратитесь к этому коду, чтобы создать рабочий элемент задачи с родительской ссылкой (обновите его в соответствии с вашими требованиями):

var url = new Uri("https://XXX.visualstudio.com"); 
            var connection = new VssConnection(url, new VssClientCredentials());
            var workitemClient = connection.GetClient<WorkItemTrackingHttpClient>();
            string projectName = "[project name]";
            int parentWITId = 771;//parent work item id
            var patchDocument = new Microsoft.VisualStudio.Services.WebApi.Patch.Json.JsonPatchDocument();
            patchDocument.Add(new Microsoft.VisualStudio.Services.WebApi.Patch.Json.JsonPatchOperation() {
                Operation=Operation.Add,
                Path= "/fields/System.Title",
                Value="parentandchildWIT"
            });
            patchDocument.Add(new Microsoft.VisualStudio.Services.WebApi.Patch.Json.JsonPatchOperation()
            {
                Operation = Operation.Add,
                Path = "/relations/-",
                Value = new
                {
                    rel = "System.LinkTypes.Hierarchy-Reverse",
                    url = connection.Uri.AbsoluteUri+ projectName+ "/_apis/wit/workItems/"+parentWITId,
                    attributes = new
                    {
                        comment = "link parent WIT"
                    }
                }
            });
            var createResult = workitemClient.CreateWorkItemAsync(patchDocument, projectName, "task").Result;
person starian chen-MSFT    schedule 10.01.2018
comment
Отличный материал, спасибо! Кроме того, я обрабатываю иерархически и создаю поиск по ходу, включая URL-адрес рабочего элемента, поэтому я могу предоставить URL-адрес рабочего элемента, определенный во время создания, вместо того, чтобы создавать его позже. - person Ross; 11.01.2018