Condividi tramite

Definire i tipi di elementi di lavoro disponibili per la sincronizzazione

  • Articolo

Prima di poter sincronizzare dati tra i server Visual Studio Team Foundation Server (TFS) e Microsoft Project, è necessario configurare l'integrazione dei due prodotti server. Durante le attività di configurazione, è necessario associare un piano del progetto dell'organizzazione a un progetto team e specificare i tipi di elementi di lavoro che parteciperanno alla sincronizzazione. Dopo avere eseguito le configurazioni iniziali e il mapping, è possibile modificare i tipi di elementi di lavoro mappati.

È possibile gestire i tipi di elementi di lavoro che partecipano alla sincronizzazione tramite le opzioni seguenti dello strumento da riga di comando TfsAdmin ProjectServer:

  • /MapWorkItemTypes: definisce i tipi di elementi di lavoro che possono prendere parte alla sincronizzazione per un progetto team. Sebbene sia possibile eseguire il mapping di molti tipi, vengono sincronizzati unicamente gli elementi di lavoro inviati per la pubblicazione.

  • /GetMappedWorkItemTypes: restituisce l'elenco di tipi di elementi di lavoro configurati per prendere parte alla sincronizzazione per un progetto team.

  • /UnmapWorkItemTypes: consente di rimuovere tipi di elemento di lavoro dalla partecipazione alla sincronizzazione per un progetto team.

Per informazioni generali su come integrare i due prodotti server, vedere Configurare l'integrazione TFS-Project Server. Per informazioni generali su come associare un progetto dell'organizzazione a un progetto team, vedere Gestire l'associazione di progetti dell'organizzazione a progetti team.

Per utilizzare lo strumento da riga di comando TfsAdmin ProjectServer, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e digitare:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%..

Requisiti

Per utilizzare questi comandi, è necessario che l'autorizzazione Amministrazione integrazione di Project Server sia impostata su Consenti. Inoltre, all'account del servizio di Team Foundation Server devono essere concesse le autorizzazioni necessarie per interagire con l'istanza di PWA che prenderà parte alla sincronizzazione dei dati. Per ulteriori informazioni, vedere Assegnare le autorizzazioni per supportare l'integrazione TFS-Project Server.

Sintassi

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]

Parametri

Parametro

Descrizione

/collection:tpcUrl

Consente di specificare l'URL (Uniform Resource Locator) di una raccolta di progetti team. Specificare l'URL nel seguente formato:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Se non si specifica una directory virtuale, specificare l'URL nel seguente formato:

http://ServerName:Port/CollectionName

/teamProject:TeamProjectName

Consente di specificare il nome di un progetto team definito nella raccolta di progetti.

/workItemTypes:ListofWorkItemTypes

Consente di specificare, in un elenco delimitato da virgole, i nomi di riferimento di uno o più tipi di elementi di lavoro. È necessario specificare solo i tipi di elementi di lavoro di cui si desidera tenere traccia dei dati in Project Professional. È possibile, ad esempio, specificare i tipi di elemento di lavoro seguenti per supportare un processo Agile come “User Story,Task” o “User Story”,Task. Non inserire uno spazio dopo la virgola.

/skipUIChanges

Consente di specificare che la scheda Project Server nel form dell'elemento di lavoro non deve essere modificata per i tipi specificati. È necessario includere questo flag se è stato personalizzata la scheda Project Server per i tipi interessati o il comando MapWorkItemTypes non potrà completare il processo. È possibile aggiornare manualmente una definizione di tipo. Per ulteriori informazioni, vedere Elementi XML aggiunti alla definizione per il tipo di elemento di lavoro.

/force

Rimuovere tutti i collegamenti che associano elementi di lavoro dei tipi specificati alle attività in Project. Se si utilizza questa opzione, è possibile rimuovere tipi di elementi di lavoro dalla partecipazione alla sincronizzazione dei dati, anche se uno o più elementi di lavoro di tale tipo sono attualmente in corso di sincronizzazione.

/? o help

Consente di visualizzare le informazioni sul comando.

Note

Quando si esegue un comando, viene visualizzato un messaggio che indica qual è l'azione da eseguire su quale oggetto. Ad esempio, il messaggio seguente indica che è in corso la configurazione di storie utente e attività per la partecipazione alla sincronizzazione dei dati.

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .

Al termine del comando viene visualizzato un altro messaggio. Ad esempio, il messaggio seguente indica che la configurazione di storie utente e attività è stata completata.

You have successfully configured the following work item types for team project ProjA: User Story, Task.

Oltre alla configurazione dei tipi di elementi di lavoro che possono partecipare alla sincronizzazione, il comando /MapWorkItemTypes consente di eseguire le operazioni seguenti:

  • Consente di aggiungere i tipi di elementi di lavoro specificati al set di tipi che partecipano alla sincronizzazione dei dati. Ovvero, il comando non annulla il mapping di alcun tipo mappato esistente.

  • Consente di aggiungere la scheda Project Server ai form per i tipi di elementi di lavoro specificati.

    Se una scheda di Project Server è già definita per un tipo di elemento di lavoro specificato, tale tipo viene ignorato e non vengono apportate modifiche ai form per gli elementi di lavoro del tipo.

Se si tenta di eseguire il mapping di tipi di elemento di lavoro per un progetto team non associato a un piano del progetto dell'organizzazione, viene visualizzato un errore. È possibile eseguire il mapping di tipi di elemento di lavoro solo per progetti team configurati per partecipare alla sincronizzazione. Per ulteriori informazioni, vedere Gestire l'associazione di progetti dell'organizzazione a progetti team.

Se si rimuove il mapping per un tipo di elemento di lavoro, la scheda Project Server viene rimossa dal form per tale tipo per il progetto team non mappato.

Prima di annullare il mapping di un tipo di elemento di lavoro per un progetto team, è necessario eliminare le attività dal piano del progetto dell'organizzazione per rimuovere tutte le associazioni tra queste e gli elementi di lavoro in Team Foundation. Dopo avere eliminato le attività dal piano del progetto dell'organizzazione, è necessario pubblicare e attendere la sincronizzazione per concludere. In alternativa, è possibile specificare il flag /force per rimuovere tutti i collegamenti che associano elementi di lavoro ad attività per il progetto team. Solo gli elementi di lavoro appartenenti ai tipi specificati vengono rimossi dalla partecipazione alla sincronizzazione.

Suggerimento

Se si eliminano le attività, è opportuno copiarle prima in un altro piano per disporre di una registrazione.

Esempi

Elencare i tipi di elementi di lavoro che sono stati mappati

Nell'esempio seguente vengono recuperati i tipi di elementi di lavoro configurati per partecipare alla sincronizzazione per il progetto team Contoso in DefaultCollection in AdventureWorksServer.

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

Eseguire il mapping di un tipo di elemento di lavoro per un progetto team

Nell'esempio seguente vengono configurate storie utente e attività per partecipare alla sincronizzazione dei dati per il progetto Contoso.

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

Rimuovere il mapping di un tipo di elemento di lavoro per un progetto team

Nell'esempio seguente vengono rimosse attività dalla partecipazione alla sincronizzazione dei dati per il progetto Contoso.

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

Vedere anche

Concetti

Specificare i tipi di elementi di lavoro da sincronizzare

Eseguire il mapping di componenti di integrazione [TfsAdmin ProjectServer]

Altre risorse

Personalizzare il mapping dei campi tra TFS e Project Server