Condividi tramite

Gestire i mapping dei campi per l'integrazione TFS-Project Server

  • Articolo

È possibile personalizzare la modalità di sincronizzazione dei dati tra Visual Studio Team Foundation Server (TFS) e Microsoft Project Server modificando il file di mapping dei campi. Questo file definisce i campi dati sincronizzati e la modalità di sincronizzazione per supportare l'integrazione di TFS 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 una raccolta di progetti team.

  • /UploadFieldMappings: consente di convalidare la sintassi XML del file di mapping dei campi e di caricarlo in una raccolta. 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 Caricare o scaricare il file di mapping di Microsoft Project [TFSFieldMapping].

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

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 per la raccolta 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 Assegnare le autorizzazioni per supportare l'integrazione TFS-Project Server.

Sintassi

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

TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/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'URI nel seguente formato:

http://ServerName:Port/CollectionName

/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 del sito Web Microsoft: Virtualizzazione del registro 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 per il mapping di campi per l'integrazione TFS-Project Server.

/force

Consente di sovrascrivere il file di mapping esistente. È necessario specificare questa opzione se si specifica l'opzione /useDefaultFieldMappings nella sostituzione dei mapping esistenti con mapping diversi.

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 Limitazioni relative al mapping dei campi di Project Server nell'integrazione con TFS.

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 DefaultCollection

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

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 una raccolta 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.

Esempi

Scaricare il file di mapping dei campi definito per una raccolta 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/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Caricare il file di mapping dei campi per una raccolta di progetti team

Nell'esempio seguente AWMappingFile.xml viene caricato su AdventureWorksCollection.

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

Vedere anche

Attività

Configurare l'integrazione TFS-Project Server

Concetti

Riferimento agli elementi XML per il mapping di campi per l'integrazione TFS-Project Server

Limitazioni relative al mapping dei campi di Project Server nell'integrazione con TFS

Eseguire il mapping di componenti di integrazione [TfsAdmin ProjectServer]

Altre risorse

Personalizzare il mapping dei campi tra TFS e Project Server