Создание ошибки в Azure DevOps Services с помощью клиентских библиотек .NET

Статья
01/10/2025

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Создание новой ошибки (или любого рабочего элемента) довольно просто. Необходимо просто задать значения полей и отправить объект JSON-Patch в конечную точку REST.

Необходимые условия

Прежде чем создать рабочий элемент, выполните указанные ниже действия.

Организация в Azure DevOps Services. Если у вас нет учетной записи, вы можете создать её бесплатно
Персональный токен доступа узнать, как его создать
В среде разработки C# вы можете использовать Visual Studio

Создание проекта C# в Visual Studio

Чтобы узнать о программировании C# в Visual Studio, найдите документацию по программированию Visual Studio C#

Содержимое кода C#

В следующем примере кода происходит несколько действий.

Аутентификация
1. Создание учетных данных с помощью PAT
2. Создание VSSConnection с помощью URI Azure DevOps Services и учетных данных
Получение доступа к клиенту с помощью VSSConnection
Создание ошибки
1. Создание массива объектов для задания значений полей
2. Преобразование этого массива в сериализованный объект JSON
3. Отправка сериализованного объекта JSON в конечную точку REST

Фрагмент кода C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using Microsoft.TeamFoundation.WorkItemTracking.WebApi;
using Microsoft.TeamFoundation.WorkItemTracking.WebApi.Models;
using Microsoft.VisualStudio.Services.Common;
using Microsoft.VisualStudio.Services.WebApi.Patch.Json;
using Microsoft.VisualStudio.Services.WebApi.Patch;
using Microsoft.VisualStudio.Services.WebApi;
using System.Net.Http.Headers;
using System.Net.Http;
using Newtonsoft.Json;

 
public class CreateBug 
{
    readonly string _uri;
    readonly string _personalAccessToken;
    readonly string _project;

    /// <summary>
    /// Constructor. Manually set values to match your organization. 
    /// </summary>
    public CreateBug()
    {
        _uri = "https://dev.azure.com/{orgName}";
        _personalAccessToken = "personal access token";
        _project = "project name";
    }

    /// <summary>
    /// Create a bug using the .NET client library
    /// </summary>
    /// <returns>Microsoft.TeamFoundation.WorkItemTracking.WebApi.Models.WorkItem</returns>    
    public WorkItem CreateBugUsingClientLib()
    {
        Uri uri = new Uri(_uri);
        string personalAccessToken = _personalAccessToken;
        string project = _project;

        VssBasicCredential credentials = new VssBasicCredential("", _personalAccessToken);
        JsonPatchDocument patchDocument = new JsonPatchDocument();

        //add fields and their values to your patch document
        patchDocument.Add(
            new JsonPatchOperation()
            {
                Operation = Operation.Add,
                Path = "/fields/System.Title",
                Value = "Authorization Errors"
            }
        );

        patchDocument.Add(
            new JsonPatchOperation()
            {
                Operation = Operation.Add,
                Path = "/fields/Microsoft.VSTS.TCM.ReproSteps",
                Value = "Our authorization logic needs to allow for users with Microsoft accounts (formerly Live Ids) - http:// msdn.microsoft.com/library/live/hh826547.aspx"
            }
        );

        patchDocument.Add(
            new JsonPatchOperation()
            {
                Operation = Operation.Add,
                Path = "/fields/Microsoft.VSTS.Common.Priority",
                Value = "1"
            }
        );

        patchDocument.Add(
            new JsonPatchOperation()
            {
                Operation = Operation.Add,
                Path = "/fields/Microsoft.VSTS.Common.Severity",
                Value = "2 - High"
            }
        );
        VssConnection connection = new VssConnection(uri, credentials);
        WorkItemTrackingHttpClient workItemTrackingHttpClient = connection.GetClient<WorkItemTrackingHttpClient>();

        try
        {
            WorkItem result = workItemTrackingHttpClient.CreateWorkItemAsync(patchDocument, project, "Bug").Result;

            Console.WriteLine("Bug Successfully Created: Bug #{0}", result.Id);

            return result;
        }
        catch (AggregateException ex)
        {
            Console.WriteLine("Error creating bug: {0}", ex.InnerException.Message);
            return null;
        }
    }
}

Дальнейшие действия

Ознакомьтесь с другим руководством в формате Quickstart: Используйте запросы для получения списка рабочих элементов
Ознакомьтесь с образцами интеграции

Поделиться через