Gestire i tipi di elementi di lavoro disponibili per la sincronizzazione

Prima di poter sincronizzare i dati tra Visual Studio Team Foundation Server 2012 e il server 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 di Team Foundation Server e 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 Visual Studio o Team Explorer è installato e immettere:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

Autorizzazioni necessarie

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 di Project Server e Team Foundation Server.

[!NOTA]

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi elevati, scegliere Start, aprire il menu di scelta rapida per il Prompt dei comandi, quindi scegliere Esegui come amministratore.Per ulteriori informazioni, vedere la seguente pagina nel sito Web Microsoft: Controllo dell'account utente.

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://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Se non si specifica una directory virtuale, specificare l'URL nel seguente formato: http://NomeServer:Porta/NomeInsieme
/teamProject:NomeProgettoTeam	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.Ad esempio, è possibile specificare i tipi seguenti di elementi di lavoro per supportare un processo Agile come "Storia utente,Attività" o "Storia utente",Attività.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 personalizzato la scheda Project Server per i tipi interessati o il comando MapWorkItemTypes non può completare.È 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.

Torna all'inizio

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 completare.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.

Torna all'inizio

Esempi

Elencare i tipi di elementi di lavoro mappati

Nell'esempio vengono recuperati i tipi di elementi di lavoro configurati per prendere parte 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

Torna all'inizio

Vedere anche

Concetti

Specificare tipi di elemento di lavoro che è possibile sincronizzare

Gestire l'integrazione di Project Server con TfsAdmin ProjectServer

Altre risorse

Personalizzare il mapping dei campi tra Project Server e Team Foundation Server