Gestire mapping dei campi per l'integrazione di Team Foundation Server e Project Server
È possibile personalizzare la modalità di sincronizzazione dei dati tra Visual Studio Team Foundation Server 2012 e Microsoft Project server modificando il file di mapping 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 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 di mapping dei campi per l'integrazione di Team Foundation Server e Project Server e Personalizzare il 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 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 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 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 /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://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. .gif "Nota") 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 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 specifica l'opzione /useDefaultFieldMappings quando si sostituiscono i mapping esistenti con diversi mapping. |
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 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.
.gif "Gg412643.collapse_all(it-it,VS.110).gif")
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.
.gif "Nota importante") 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 Data Types and Field Mapping Criteria. |
Torna all'inizio
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 campi per una raccolta di progetti team
Nell'esempio seguente viene caricata AWMappingFile.xml a AdventureWorksCollection.
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
Torna all'inizio
Vedere anche
Attività
Configurare l'integrazione di Team Foundation Server e Project Server
Concetti
Gestire l'integrazione di Project Server con TfsAdmin ProjectServer
Altre risorse
Personalizzare il mapping dei campi tra Project Server e Team Foundation Server