Compartilhar via


Criar um item de trabalho usando o modelo do objeto cliente para Team Foundation

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

  1. Construir uma WorkItem.

  2. Defina os valores dos campos de preenchimento obrigatório.

  3. Salve a WorkItem.

Exemplo

Dependendo do tipo de WorkItem que você cria, Fields mais necessárias têm valores padrão. Se esses valores forem adequados, você não precisa defini-los explicitamente. Por exemplo, você pode criar uma história de usuário, conforme definido em Desenvolvimento de software MSF para Agile para Visual Studio ALM. Para este tipo de WorkItem, os Estado, Motivo e Atribuído para Fields são todos obrigatórios, mas têm valores padrão. Quando uma história de usuário é criada, o estado padrão é "Ativo", o motivo padrão é "Novo", e o valor padrão do atribuído ao campo é o usuário atual. No entanto, o título é obrigatório e não tem nenhum valor padrão. Portanto, você deve definir o título quando criar uma história de usuário. Para obter mais informações, consulte História de usuário (Agile) [redirecionado] e Uma exibição completa do que você pode configurar e personalizar no Visual Studio TFS. O exemplo a seguir cria uma história de usuário; define o título, que é obrigatório; e define a descrição, que não é obrigatória.

História do usuário

Para usar este exemplo

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

  2. Adicione referências aos assemblies a seguir:

  3. Substitua o conteúdo de Program.cs (ou Module1.vb) por 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 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

Dica

Você pode salvar mais de um WorkItem ou WorkItemLink em uma única viagem de ida e volta, usando o método WorkItemStore.BatchSave.

Consulte também

Tarefas

Editar e salvar itens de trabalho usando o modelo do objeto cliente para Team Foundation

Referência

BatchSave

Conceitos

Estendendo o acompanhamento do item de trabalho usando o modelo do objeto cliente para Team Foundation

Escrevendo código para tipos diferentes de itens de trabalho usando o modelo do objeto cliente para Team Foundation