Partager via

Créer un élément de travail à l'aide du Modèle d'objet client pour Team Foundation

  • Article

Vous pouvez créer des éléments de travail pour les bogues, les tâches, ainsi que d'autres types de WorkItem en procédant comme suit :

  1. Construisez WorkItem.

  2. Définissez les valeurs des champs obligatoires.

  3. Enregistrez WorkItem.

Exemple

Selon le type de WorkItem que vous créez, la plupart des Fields obligatoires ont des valeurs par défaut. Si ces valeurs sont appropriées, vous n'avez pas à les définir explicitement. Par exemple, vous pouvez créer un récit utilisateur comme indiqué dans Modèle de processus Agile pour Visual Studio ALM. Pour ce type de WorkItem, les Fields État, Raison et Assigné à sont tous obligatoires mais ont des valeurs par défaut. Quand un récit utilisateur est créé, son état par défaut est « Actif », sa raison par défaut est « Nouveau » et la valeur par défaut du champ Assigné à est celle de l'utilisateur actuel. Toutefois, le titre est obligatoire et n'a aucune valeur par défaut. Ainsi, vous devez définir le titre quand vous créez un récit utilisateur. Pour plus d’informations, consultez Récit utilisateur (Agile) [redirection] et Une perspective complète de ce que vous pouvez configurer et personnaliser dans Visual Studio TFS. L'exemple suivant crée un récit utilisateur, définit le titre (obligatoire) et la description (non obligatoire).

Récit utilisateur

Pour utiliser cet exemple

  1. Créez une application console C# (ou VB).

  2. Ajoutez des références aux assemblys suivants :

  3. Remplacez le contenu de Program.cs (ou Module1.vb) par cet exemple.

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

Notes

Vous pouvez enregistrer plusieurs WorkItem ou WorkItemLink en un seul aller-retour à l'aide de la méthode WorkItemStore.BatchSave.

Voir aussi

Tâches

Modifier et enregistrer des éléments de travail à l'aide du Modèle d'objet client pour Team Foundation

Référence

BatchSave

Concepts

Extension du suivi des éléments de travail à l'aide du Modèle d'objet client pour Team Foundation

Écrire du code pour différents types d'éléments de travail à l'aide du Modèle d'objet client pour Team Foundation