Creare un elemento di lavoro tramite il modello a oggetti del client per Team Foundation
È possibile creare bug, attività e altri tipi WorkItemoggetti eseguendo i passaggi seguenti:
Esempio
A seconda del tipo WorkItem creati, la maggior parte Fields obbligatori hanno valori predefiniti.Se questi valori sono corretti, non è necessario impostarle in modo esplicito.Ad esempio, è possibile creare una storia utente come definito in Modello di processo Agile per ALM di Visual Studio.Per questo tipo WorkItem, lo stato e motivo, assegnato a Fields tutto è necessario ma con valori predefiniti.Quando una storia utente viene creata, il relativo stato predefinito è “design„, il motivo predefinito è “nuovo„, e il valore predefinito del campo assegnato all'utente corrente.Tuttavia, il titolo è obbligatorio e non ha valore predefinito.Pertanto, è necessario impostare il titolo quando si crea una storia utente.Per ulteriori informazioni, vedere Storia utente (Agile) e Personalizzare progetti e processi del team.Nell'esempio seguente viene creata una storia utente; imposta il titolo, che è obbligatorio, set e la descrizione, che non è necessaria.
.png "Storia utente")
Per utilizzare questo esempio
Creare un'applicazione console VB o (C#).
Aggiungere riferimenti agli assembly riportati di seguito:
Sostituire il contenuto Program.cs o Module1.vb) con questo esempio.
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
[!NOTA]
È possibile salvare più di un WorkItem o WorkItemLink in un unico round trip tramite il metodo WorkItemStore.BatchSave.
Vedere anche
Attività
Modificare e salvare elementi di lavoro tramite il modello a oggetti del client per Team Foundation