使用 .NET 用戶端連結庫在 Azure DevOps Services 中建立 Bug

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

建立新的 Bug（或任何工作項目）相當直接。 您只需要設定域值，並將 JSON-Patch 物件傳送至 REST 端點。

必要條件

您必須先具備下列專案，才能建立工作專案。

• Azure DevOps Services 中的組織。 如果您沒有帳戶，您可以 免費建立一個
• 個人存取令牌， 瞭解如何建立個人存取令牌
• C# 開發環境，您可以使用 Visual Studio

在 Visual Studio 中建立 C# 專案

若要瞭解 Visual Studio 中的 C# 程式設計，請尋找 Visual Studio C# 程式設計檔

C# 程式代碼內容

下列程式代碼範例中有一些情況：

1. 認證
   1. 使用 PAT 建立認證
   2. 使用您的 Azure DevOps Services URI 和認證建立 VSS 連線 ion
2. 使用 VSS 擷取用戶端 連線
3. 建立 Bug
   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;
        }
    }
}

下一步

• 請參閱另一個快速入門： 使用查詢取得工作專案清單
• 探索整合範例