Erstellen einer Arbeitsaufgabe mithilfe des Clientobjektmodells für Team Foundation

Sie können Fehler, Aufgaben und andere Arten von WorkItemn erstellen, indem Sie folgende Schritte ausführen:

1. Erstellen Sie eine WorkItem.

2. Geben Sie die Werte für die erforderlichen Felder an.

3. Sichern Sie die WorkItem.

Beispiel

Je nach der Art der erstellten WorkItem sind für die meisten erforderlichen Fields Standardwerte angegeben. Wenn diese Werte passen, müssen Sie sie nicht extra einstellen. Sie erstellen beispielsweise einen Benutzertextabschnitt wie in MSF für Agile Software Development für Visual Studio ALM definiert. Für diese Art von WorkItem sind die Fields "Zustand", "Grund" und "Zugewiesen zu" alle erforderlich, weisen jedoch Standardwerte auf. Wenn ein Benutzertextabschnitt erstellt wird, ist der Standardzustand "Aktiv", der Standardgrund ist "Neu" und der Standardwert für "Zugewiesen zu" ist der aktuelle Benutzer. Der Titel ist jedoch erforderlich und weist keinen Standardwert auf. Sie müssen daher beim Erstellen eines Benutzertextabschnittes einen Titel festlegen. Weitere Informationen finden Sie unter Benutzerbericht (Agile) [umgeleitet] und Eine End-to-End-Ansicht der in Visual Studio TFS konfigurierbaren und anpassbaren Elemente. Im folgenden Beispiel wird ein Benutzertextabschnitt erstellt, der Titel, der erforderlich ist, wird festgelegt, und eine Beschreibung, die nicht erforderlich ist, wird angegeben.

So verwenden Sie dieses Beispiel

1. Erstellen Sie eine C#- (oder VB-) Konsolenanwendung.

2. Fügen Sie Verweise auf die folgenden Assemblys hinzu:

   • Microsoft.TeamFoundation

   • Microsoft.TeamFoundation.Client

   • Microsoft.TeamFoundation.WorkItemTracking.Client

3. Ersetzen Sie den Inhalt von Program.cs ( oder Module1.vb ) durch dieses Beispiel.

using System;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.WorkItemTracking.Client;

namespace WorkItemTrackingSample
{
    class Program
    {
        static void Main(string[] args)
        {            // Connect to the server and the store, and get the WorkItemType object
            // for user stories from the team project where the user story will be created. 
            Uri collectionUri = (args.Length < 1) ?
                new Uri("http://server:port/vdir/DefaultCollection") : new Uri(args[0]);
            TfsTeamProjectCollection tpc = new TfsTeamProjectCollection(collectionUri);
            WorkItemStore workItemStore = tpc.GetService<WorkItemStore>();
            Project teamProject = workItemStore.Projects["DinnerNow"];
            WorkItemType workItemType = teamProject.WorkItemTypes["User Story"];

            // Create the work item. 
            WorkItem userStory = new WorkItem(workItemType)
            {
                // The title is generally the only required field that doesn’t have a default value. 
                // You must set it, or you can’t save the work item. If you’re working with another
                // type of work item, there may be other fields that you’ll have to set.
                Title = "Recently ordered menu",
                Description =
                    "As a return customer, I want to see items that I've recently ordered."
            };

            // Save the new user story. 
            userStory.Save();
        }
    }
}

Imports System
Imports Microsoft.TeamFoundation.Client
Imports Microsoft.TeamFoundation.WorkItemTracking.Client
Module Module1

    Sub Main(ByVal sArgs() As String)
        ' Connect to the server and the store and get the WorkItemType object
        ' for user stories from the team project where the user story will be created.

        Dim collectionUri As Uri
        If sArgs.Length = 0 Then
            collectionUri = New Uri("https://Server:8080/tfs/DefaultCollection")
        Else
            collectionUri = New Uri(sArgs(1))
        End If

        Dim tpc As New TfsTeamProjectCollection(collectionUri)
        Dim workItemStore As WorkItemStore
        workItemStore = tpc.GetService(Of WorkItemStore)()
        Dim teamProject As Project
        teamProject = workItemStore.Projects("DinnerNow")
        Dim workItemType As WorkItemType
        workItemType = teamProject.WorkItemTypes("User Story")

        ' Create the work item
        Dim userStory As New Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem(workItemType)

       ' The title is generally the only required field that doesn’t have a default value. 
       ' You must set it, or you can’t save the work item. If you’re working with another
       ' type of work item, there may be other fields that you’ll have to set.
        userStory.Title = "Recently Ordered Menu"
        userStory.Description = "As a return customer, I want to see items that I've recently ordered"

        ' Save the new user story
        userStory.Save()



    End Sub

End Module

Hinweis

Sie können mehr als eine WorkItem oder einen WorkItemLink in einem einzelnen Roundtrip sichern, indem Sie die WorkItemStore.BatchSave-Methode verwenden.

Siehe auch

Aufgaben

Bearbeiten und Speichern von Arbeitsaufgaben mithilfe des Clientobjektmodells für Team Foundation

Referenz

BatchSave

Konzepte

Erweitern der Arbeitsaufgabennachverfolgung mithilfe des Clientobjektmodells für Team Foundation

Schreiben von Code für verschiedene Arbeitsaufgabentypen unter Verwendung des Clientobjektmodells für Team Foundation