Crie um item de trabalho usando o modelo de objeto de cliente para o team foundation

  • Artigo

Você pode criar, bugs, tarefas e outros tipos de WorkItems executando as seguintes etapas:

  1. Construir WorkItem.

  2. Definir os valores dos campos necessários.

  3. Salve WorkItem.

Exemplo

Dependendo do tipo de WorkItem que você cria, a maioria de Fields exigido tem valores padrão.Se esses valores são adequadas, você não precisa explicitamente veja.Por exemplo, você pode criar um artigo de usuário como definido em Modelo de processo Agile para o Visual Studio ALM.Para este tipo de WorkItem, o estado, motivo, e atribuído a Fields todo é necessário mas tem valores padrão.Quando um artigo de usuário é criada, o estado padrão é “,” ativa a razão padrão é “novo”, e o valor padrão de atribuído ao campo é o usuário atual.Em o entanto, o título é necessário e não tem valor padrão.Portanto, você deve definir o título quando você cria um artigo de usuário.Para obter mais informações, consulte História de usuário (Agile) e Personalizar projetos de equipe e processos.O exemplo a seguir cria um artigo do usuário; define o título, que é necessário; define e a descrição, que não é necessária.

História de usuário

Para usar este exemplo

  1. Crie um aplicativo de console do C# (ou VB).

  2. Adicione referências para os seguintes conjuntos de módulos (assemblies) :

  3. Substitua o conteúdo de Module.vb (ou Module1.vb) com esse exemplo.

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
ObservaçãoObservação

Você pode salvar mais de um WorkItem ou WorkItemLink em uma única processamento usando o método de WorkItemStore.BatchSave .

Consulte também

Tarefas

Itens de trabalho de edição e de salvar usando o modelo de objeto de cliente para o team foundation

Referência

BatchSave

Conceitos

Estendendo o acompanhamento de item de trabalho usando o modelo de objeto de cliente para o team foundation

Escrevendo código para diferentes tipos de itens de trabalho usando o modelo de objeto de cliente para o team foundation