Een fout maken in Azure DevOps Services met behulp van .NET-clientbibliotheken

Artikel
04/04/2024

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

Het maken van een nieuwe fout (of een werkitem) is vrij eenvoudig. U hoeft alleen de veldwaarden in te stellen en een JSON-Patch-object naar het REST-eindpunt te verzenden.

Vereisten

U moet het volgende hebben voordat u een werkitem kunt maken.

Een organisatie in Azure DevOps Services. Als u er nog geen hebt, kunt u er gratis een maken
Een persoonlijk toegangstoken, ontdek hoe u er een kunt maken
Een C#-ontwikkelomgeving, kunt u Visual Studio gebruiken

Een C#-project maken in Visual Studio

Raadpleeg de visual Studio C#-programmeerdocumentatie voor meer informatie over C#-programmering in Visual Studio

C#-code-inhoud

Er gebeuren enkele dingen in het volgende codevoorbeeld:

Verificatie
1. Referenties maken met uw PAT
2. Een VSS Verbinding maken ion maken met uw Azure DevOps Services-URI en de referenties
De client ophalen met behulp van uw VSS Verbinding maken ion
De fout maken
1. Een matrix met objecten maken om de veldwaarden in te stellen
2. Deze matrix converteren naar een geserialiseerd json-object
3. Dat geserialiseerd json-object verzenden naar het REST-eindpunt

C#-codefragment

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;
        }
    }
}

Volgende stappen

Bekijk een andere quickstart: Een lijst met werkitems ophalen met behulp van query's
De integratievoorbeelden verkennen

Delen via