Gestione di mapping dei campi per l'integrazione di Team Foundation Server e Project Server

Articolo
08/11/2011

È possibile personalizzare la modalità di sincronizzazione dei dati tra Visual Studio Team Foundation Server 2010 e Project Server modificando il file di mapping dei campi. Questo file consente di definire i campi dati sincronizzati e la modalità di sincronizzazione per supportare l'integrazione di Team Foundation Server e Project Server. È possibile gestire questo file tramite le opzioni seguenti dello strumento da riga di comando TFSAdmin ProjectServer:

/DownloadFieldMappings: consente di scaricare il file di mapping dei campi definito per un insieme di progetti team.
/UploadFieldMappings: consente di convalidare la sintassi XML del file di mapping dei campi e di caricarlo in un insieme. Per convalidare la sintassi ma non caricare il file, è possibile utilizzare l'opzione /validateonly.

Nota

Il file di mapping dei campi per l'integrazione di Team Foundation Server e Project Server è distinto dal file di mapping dei campi per Microsoft Project. Per informazioni su come scaricare o caricare il secondo file, vedere TFSFieldMapping.

Per ulteriori informazioni sul contenuto del file di mapping su come scaricarlo, vedere Riferimento agli elementi XML di mapping dei campi per l'integrazione di Team Foundation Server e Project Server e Personalizzazione del mapping dei campi tra Project Server e Team Foundation Server.

Per utilizzare lo strumento da riga di comando TFSAdmin ProjectServer, aprire una finestra del prompt dei comandi in un computer che esegue Team Explorer e Visual Studio Team Foundation Server 2010 Service Pack 1. Eseguire lo strumento dalla directory seguente: Unità:Programmi\Microsoft Visual Studio 10.0\Common7\IDE. Nei computer a 64 bit, lo strumento si trova in Unità:\Programmi (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Autorizzazioni necessarie

Per utilizzare questi comandi, è necessario che l'autorizzazione Amministrazione integrazione di Project Server sia impostata su Consenti per l'insieme di progetti team. Inoltre, all'account del servizio di Team Foundation Server devono essere concesse le autorizzazioni necessarie per interagire con l'istanza di Project Web Access o Project Web App (PWA) che prenderà parte alla sincronizzazione dei dati. Per ulteriori informazioni, vedere Assegnazione di 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, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi, quindi scegliere Esegui come amministratore. Per ulteriori informazioni, vedere la pagina del sito Web Microsoft Controllo dell'account utente.

Sintassi

TFSAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TFSAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

Parametri

Parametro	Oggetto di descrizione
/collection:tpcURL	Consente di specificare l'URL (Uniform Resource Locator) di un insieme di progetti team. Specificare l'URL nel seguente formato: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Se non si specifica una directory virtuale, specificare l'URI nel seguente formato: http://NomeServer:Porta/NomeInsieme
/filePath:mappingFile	Consente di specificare il percorso e il nome file del file di definizione XML contenente il mapping dei campi. Nota Se si utilizza Windows Vista, è possibile che non si disponga delle autorizzazioni per accedere ad alcune cartelle.Se si tenta di esportare il tipo di elemento di lavoro in una posizione per la quale non si dispone di autorizzazioni, la tecnologia di virtualizzazione del Registro di sistema reindirizzerà automaticamente il file esportato e lo salverà nell'archivio virtuale.Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone di autorizzazioni. Per ulteriori informazioni, vedere le pagine seguenti nel sito Web Microsoft: Virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.
/encoding:encoding	Consente di specificare il nome di un formato di codifica per .NET Framework 2.0. Il comando consente di esportare o importare i dati XML nel formato di codifica specificato. Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7). Se non si specifica questo parametro, il comando tenta di rilevare la codifica e utilizza la codifica UTF-8 in caso di mancato rilevamento.
/validateOnly	Consente di convalidare il file di mapping ma non di caricarlo.
/useDefaultFieldMappings	Consente di caricare i mapping campi predefiniti anziché un file di mapping personalizzato. Per ulteriori informazioni, vedere Riferimento agli elementi XML di mapping dei campi per l'integrazione di Team Foundation Server e Project Server.
/force	Consente di sovrascrivere il file di mapping esistente. È necessario specificare questa opzione se si sostituiscono i mapping esistenti con mapping diversi.

Torna all'inizio

Note

È possibile eseguire il mapping solo di campi personalizzati dell'organizzazione o di campi che sono incorporati in Project Server. È necessario specificare il nome di un campo valido in Progetto. Per determinare il nome di un campo incorporato, rimuovere qualsiasi spazio dal nome descrittivo e far precedere il risultato da "pj." Ad esempio, il nome del campo per Manager stato è pjStatusManager, mentre il nome del campo per Custom 01 è pjCustom01. Esistono limitazioni relative all'esecuzione del mapping dei campi incorporati e personalizzati ed è quindi necessario far corrispondere i tipi di dati. Per ulteriori informazioni, vedere Restrizioni relative al mapping dei campi di Project Server per l'integrazione con Team Foundation Server.

Quando si esegue un comando TFSAdmin ProjectServer, viene visualizzato un messaggio indicante l'azione da eseguire e l'oggetto interessato. Ad esempio, il messaggio seguente indica che è in corso il download del file di mapping dei campi:

Download field mappings from Collection0

Al completamento delle azioni del comando viene visualizzato un altro messaggio. Ad esempio, al termine del download del file di mapping dei campi viene visualizzato il messaggio seguente:

You have downloaded field mappings to C:MappingFile. . . Done.

Note sul caricamento di mapping dei campi

Quando viene eseguita l'opzione /UploadFieldMappings, si verificano le azioni seguenti:

Se non è definito alcun mapping dei campi per l'insieme di progetti team e non si specifica l'opzione /useDefaultFieldMappings, viene visualizzato un messaggio in cui si richiede all'utente di creare un mapping dei campi predefinito.
Se esistono mapping dei campi e si specifica l'opzione /useDefaultFieldMappings, viene visualizzato un messaggio in cui si chiede all'utente di confermare se si desidera sovrascrivere i mapping esistenti.
È necessario specificare l'opzione /force se si desidera sovrascrivere i mapping dei campi che sono stati caricati precedentemente in un insieme.
Il file di mapping dei campi viene convalidato prima del caricamento. Se si dispone di un errore di sintassi o se è stato specificato un campo non valido, viene visualizzato un messaggio di errore.

Se il caricamento di un file di mapping dei campi viene completato, vengono apportate le modifiche seguenti:

Ogni campo mirror in Team Foundation viene configurato per essere conforme ai campi mappati.
Per tipi di elemento di lavoro di cui è stato eseguito il mapping per un insieme o un progetto team, i nuovi mapping vengono visualizzati nella scheda Project Server del form elemento di lavoro.

Importante
Quando si esegue il mapping di un campo da Team Foundation Server a Project Server, accertarsi che i tipi di dati di tali campi corrispondano. In caso contrario, si potrebbe ricevere l'errore seguente quando si tenta di caricare i mapping dei campi: L'indice (in base zero) deve essere maggiore o uguale a zero e minore della dimensione dell'elenco degli argomenti. Per ulteriori informazioni, vedere Tipi di dati e criteri di mapping dei campi.

Quando si esegue il mapping di un campo da Team Foundation Server a Project Server, accertarsi che i tipi di dati di tali campi corrispondano. In caso contrario, si potrebbe ricevere l'errore seguente quando si tenta di caricare i mapping dei campi:

L'indice (in base zero) deve essere maggiore o uguale a zero e minore della dimensione dell'elenco degli argomenti.

Per ulteriori informazioni, vedere Tipi di dati e criteri di mapping dei campi.

Torna all'inizio

Esempi

Scaricare il file di mapping dei campi definito per un insieme di progetti team.

Nell'esempio seguente vengono scaricati i mapping dei campi definiti per AdventureWorksCollection in AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Caricare il file di mapping campi per un insieme di progetti team

Nell'esempio seguente viene caricato AWMappingFile.xml in AdventureWorksCollection e viene sovrascritto qualsiasi mapping dei campi definito in precedenza.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

Torna all'inizio