Vytvořit pracovní položku pomocí objektového modelu klient Team Foundation

Můžete vytvořit chyby, úkoly a další typy WorkItems provedením následujících kroků:

1. Konstrukce WorkItem.

2. Nastavte hodnoty požadovaných polí.

3. Save the WorkItem.

Příklad

Podle typu WorkItem , vytvořit většinu požadovaných Fields výchozí hodnoty.Pokud tyto hodnoty jsou vhodné, není nutné explicitně nastavena.Například můžete vytvořit textu uživatelem definované v Agilní šablona projektu pro Visual Studio ALM.Pro tento typ WorkItem, stát, z důvodu a přiřazeno Fields jsou požadována, ale výchozí hodnoty.Vytvoření uživatele story, výchozího stavu "Aktivní", z důvodu jeho výchozí je "Nový" a výchozí hodnotu poli Přiřazeno je aktuální uživatel.Nadpis však je vyžadován a nemá výchozí hodnotu.Proto je třeba nastavit název při vytváření textu uživatelem.Další informace naleznete v tématu Uživatel Story (agilní) a Přizpůsobení týmových projektů a procesů.Následující příklad vytvoří uživatele článku. Nastaví název, který je vyžadován; a nastaví popis není vyžadováno.

Chcete-li použít tento příklad

1. Vytvoří aplikaci konzole C# (nebo jazyka Visual Basic).

2. Přidejte odkazy do následujících sestavení:

   • Microsoft.TeamFoundation

   • Microsoft.TeamFoundation.Client

   • Microsoft.TeamFoundation.WorkItemTracking.Client

3. V tomto příkladu nahradíte obsah Program.cs (nebo Module1.vb).

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 the only required field that does not have a default value. 
                // You must set it, or you cannot save the work item. 
                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("UserTypes")

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

        ' The title is the only required field that does not have a default value
        ' You must set it, or you cannot save the item
        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

[!POZNÁMKA]

Lze uložit více než jeden WorkItem nebo WorkItemLink v pomocí jediného round trip WorkItemStore.BatchSave metoda.

Viz také

Úkoly

Upravte a uložte pracovní položky pomocí objektového modelu klient pro Team Foundation

Referenční dokumentace

BatchSave

Koncepty

Rozšíření pracovní položku sledování pomocí objektového modelu klient pro Team Foundation

Psaní kódu pro různé typy pracovních položek pomocí objektového modelu klient pro Team Foundation