如何通过Azure DevOps客户端库为用户故事添加并关联多个任务

看起来你已经离解决问题很近了！任务能正常创建但没和用户故事建立关联，核心问题出在**System.Parent字段的类型处理**上。

问题根源 #

你在GetTaskPatchDoc方法里把userStoryID转成了字符串传递给System.Parent字段，但Azure DevOps的System.Parent字段期望的是整数类型的值，而非字符串。当你传递字符串时，API会判定这个值无效并静默忽略，最终导致关联失败。

修复方案 #

修改GetTaskPatchDoc方法里的字典项，直接传递整数类型的userStoryID，不要转成字符串：

private JsonPatchDocument GetTaskPatchDoc(int userStoryID, UseCaseADO task) {
    JsonPatchDocument patchDocument = new JsonPatchDocument();
    // 关键修改：System.Parent的值直接用int类型，无需转字符串
    var values = new Dictionary<string, object>() {
        { "/fields/System.Title", task.Title1 },
        { "/fields/System.Description", task.Description},
        { "/fields/System.State", task.State },
        { "/fields/System.Tags", task.Tags },
        { "/fields/Microsoft.VSTS.Common.StackRank", task.StackRank},
        { "/fields/Microsoft.VSTS.Common.Priority", task.Priority },
        { "/fields/System.Parent", userStoryID }
    };
    foreach (var kvp in values) {
        patchDocument.Add(new JsonPatchOperation() {
            Operation = Operation.Add,
            Path = kvp.Key,
            Value = kvp.Value
        });
    }
    return patchDocument;
}

额外验证点 #

• 确认userStoryID是有效的用户故事工作项ID，且该工作项确实存在于你的目标项目中；
• 检查你的Personal Access Token（PAT）是否拥有**Work Items (Write)**权限，权限不足也会导致关联操作静默失败。

备选方案：通过Relations关联 #

如果字段设置的方式仍有问题，你也可以通过添加层级关系的方式建立关联，这种方式更直观，和手动在Azure DevOps界面设置父项的效果完全一致：

private JsonPatchDocument GetTaskPatchDoc(int userStoryID, UseCaseADO task, Uri projectUri) {
    JsonPatchDocument patchDocument = new JsonPatchDocument();
    // 添加任务基础字段
    patchDocument.Add(new JsonPatchOperation() { Operation = Operation.Add, Path = "/fields/System.Title", Value = task.Title1 });
    patchDocument.Add(new JsonPatchOperation() { Operation = Operation.Add, Path = "/fields/System.Description", Value = task.Description });
    // ... 其他字段（State、Tags等）省略 ...

    // 添加父工作项关联
    patchDocument.Add(new JsonPatchOperation() {
        Operation = Operation.Add,
        Path = "/relations/-",
        Value = new {
            rel = "System.LinkTypes.Hierarchy-Reverse",
            url = $"{projectUri.AbsoluteUri.TrimEnd('/')}/_apis/wit/workItems/{userStoryID}",
            attributes = new {
                comment = "Linked task to parent user story via API"
            }
        }
    });
    return patchDocument;
}

测试建议 #

修改后，你可以在创建任务的循环中添加日志，验证关联是否成功：

foreach (var task in tasks) {
    JsonPatchDocument patchDocument = GetTaskPatchDoc(userStoryID, task);
    WorkItem result = workItemTrackingHttpClient.CreateWorkItemAsync(patchDocument, _project, "Task").Result;
    // 打印结果确认关联状态
    var parentId = result.Fields.TryGetValue("System.Parent", out var parent) ? parent.ToString() : "未关联";
    _logger.Info($"创建任务ID：{result.Id}，关联的用户故事ID：{parentId}");
}

如果还是失败，建议打印完整的异常堆栈（不要只捕获InnerException.Message），API通常会返回更具体的错误提示，帮助定位问题。

内容的提问来源于stack exchange，提问作者SteveB