Créer un élément de travail à l'aide du Modèle d'objet client pour Team Foundation
Vous pouvez créer des bogues, des tâches, et d'autres types d' WorkItems en exécutant les étapes suivantes :
Exemple
Selon le type d' WorkItem que vous créez, la plupart des Fields requis ont des valeurs par défaut.Si ces valeurs sont appropriées, vous ne devez pas les définir explicitement.Par exemple, vous pouvez créer un récit utilisateur comme défini dans Modèle de processus Agile pour Visual Studio ALM.Pour ce type d' WorkItem, l'état, raison, et assigné à Fields tout sont requis mais ont des valeurs par défaut.Lorsqu'un récit utilisateur est créé, son état par défaut est « active », sa raison par défaut est « nouvelle », et la valeur par défaut de l'assignée au champ est l'utilisateur actuel.Toutefois, le titre est obligatoire et n'a pas de valeur par défaut.Par conséquent, vous devez définir le titre lorsque vous créez un récit utilisateur.Pour plus d'informations, consultez Récits utilisateur (Agile) et Personnaliser les projets et processus d'équipe.l'exemple suivant crée un récit utilisateur ; définit le titre, qui est requis ; et définit la description, qui n'est pas obligatoire.
.png "Récit utilisateur")
Pour utiliser cet exemple
Créez une application console C# (ou VB).
Ajoutez des références aux assemblys suivants :
Remplacez le contenu (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 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
[!REMARQUE]
Vous pouvez enregistrer plusieurs WorkItem ou WorkItemLink dans une boucle à l'aide de la méthode d' WorkItemStore.BatchSave .
Voir aussi
Tâches
Référence
Concepts
Extension du suivi des éléments de travail à l'aide du Modèle d'objet client pour Team Foundation