Gestione di campi degli elementi di lavoro

Articolo
08/11/2011

È possibile gestire i campi dei tipi di elementi di lavoro definiti per un insieme di progetti team tramite i seguenti comandi witadmin:

deletefield: Elimina il file specificato.
listfields: Elenca gli attributi per tutti i campi o un campo specificato.
indexfield: Attiva o disattiva l'indicizzazione per il campo specificato. Quando si abilita l'indicizzazione per un campo, è possibile aumentare le prestazioni dell'individuazione degli elementi di lavoro le cui query specificano quel campo. Se si aggiunge un campo personalizzato che si utilizza in molte query elemento di lavoro, è necessario abilitare l'indicizzazione per quel campo.

changefield: Modifica uno o più attributi di un campo, quale il nome campo semplice da usare, attributi per rapporti di data warehouse o la possibilità di sincronizzare un campo che contiene nomi di persona. Quando la sincronizzazione è abilitata, il campo viene aggiornato nel momento in cui vengono eseguiti degli aggiornamenti in Active Directory o in un workgroup. Per ulteriori informazioni su come utilizzare i campi per il reporting, vedere Utilizzo dei campi elementi di lavoro.

Importante
Quando si esegue l'aggiornamento da una versione precedente a quella corrente, tutti i campi incorporati l'attributo syncnamechanges viene impostato su true per tutti i campi Stringa che contengono nomi di persona. Tuttavia, è necessario assegnare manualmente l'attributo a tutti i campi personalizzati utilizzati per archiviare nomi di persona e che si desidera sincronizzare. Per ulteriori informazioni, vedere Converting the Data Type of a Work Item Field [witadmin].

Quando si esegue l'aggiornamento da una versione precedente a quella corrente, tutti i campi incorporati l'attributo syncnamechanges viene impostato su true per tutti i campi Stringa che contengono nomi di persona. Tuttavia, è necessario assegnare manualmente l'attributo a tutti i campi personalizzati utilizzati per archiviare nomi di persona e che si desidera sincronizzare. Per ulteriori informazioni, vedere Converting the Data Type of a Work Item Field [witadmin].

Lo strumento della riga di comando witadmin si trova in unità>:\Programmi\Microsoft Visual Studio 10.0\Common7\IDE nel computer client che esegue Team Explorer.

Per ulteriori informazioni sui campi, vedere Personalizzazione e utilizzo di campi elemento di lavoro.

Nota

È possibile creare e modificare campi di elementi di lavoro tramite Editor processi, uno strumento avanzato per Visual Studio. Questo strumento non è supportato. Per ulteriori informazioni, vedere la pagina seguente sul sito Web Microsoft: Power Tools di Team Foundation Server (aprile 2010).

Autorizzazioni necessarie

Per l'insieme di progetti team in cui vengono definiti i campi del tipo di elemento di lavoro, è necessario disporre del set di autorizzazioni seguente:

Per elencare i campi, è necessario essere un membro del gruppo Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti
Per eliminare o rinominare campi o modificare le caratteristiche di reportistica di un campo, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o del gruppo di sicurezza Project Administrators.

Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di 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, visitare il sito Web Microsoft Controllo dell'account utente.

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]

Parametri

Parametro	Oggetto di descrizione
/collection:CollectionURL	Specifica l'URI dell'insieme di progetti team. Il formato per l'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Se non viene utilizzata alcuna directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeInsieme
/n:RefName /n:Name	Nome di riferimento del campo di un tipo di elemento di lavoro.
/index	Specifica se abilitare o disabilitare l'indicizzazione per il campo specificato. Specificano on per abilitare l'indicizzazione e off per disabilitarla.
/name:NewName	Specifica il nuovo nome per il campo.
/syncnamechanges	Specifica l'uso del campo dell'elemento di lavoro per l'archiviazione di nomi e per l'aggiornamento delle modifiche in Active Directory o in un gruppo di lavoro. Questa opzione è valida solo quando un campo con il tipo di dati Stringa viene specificato per typename. Specificare true per abilitare la sincronizzazione per il campo dati, specificare false per disabilitarla.
/reportingname:ReportingName	Specifica il nome del campo nel data warehouse da utilizzare per il reporting.
/reportingrefname:ReportingRefName	Specifica il nome di riferimento del campo nel data warehouse da utilizzare per il reporting.
/reportingtype:Type	Specifica come il campo viene utilizzato nel warehouse per il reporting. Di seguito vengono illustrati i valori validi. dimension:, utilizzato per i campi di tipo Integer, String o DateTime. detail:, utilizzato per i campi di tipo Integer, Double, String o DateTime. measure:, utilizzato per i campi di tipo Integer e Double. Il tipo di aggregazione predefinito è somma. È possibile specificare un altro tipo di aggregazione utilizzando il parametro formula. disable:, utilizzato per disabilitare la segnalazione del campo. Per ulteriori informazioni, vedere Utilizzo dei campi elementi di lavoro.
/reportingformula:Formula	Specifica la formula di aggregazione da utilizzare quando il campo viene riportato come un measure. L'unica formula supportata è sum.
/unused	Elenca tutti i campi che non sono utilizzati da un qualsiasi progetto team definito nell'insieme di progetti team.
/noprompt	Disabilita prompt per la conferma.
/? or help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

Quando si assegna l'attributo syncnamechanges a un campo Stringa, il campo accetta sempre nomi utente validi. Tuttavia, il campo non consente nomi di gruppi archiviati in Team Foundation Server o in Active Directory se una delle condizioni seguenti è true:

La regola VALIDUSER viene specificata in tutti i tipi di elementi di lavoro
La regola VALIDUSER viene specificata per un tipo di elemento di lavoro
La regola ALLOWEDVALUES viene specificata per un tipo di elemento di lavoro e dispone di un criterio di filtro che esclude i gruppi

Per ulteriori informazioni, vedere Categorie di regole di campo: impostazioni predefinite, qualificatori, elenco, azione e regole condizionali.

Per un riepilogo dei campi di sistema indicizzati, vedere Utilizzo dei campi di sistema e dei campi definiti tramite i modelli di processo MSF.

Esempi

Se non diversamente specificato, i valori seguenti vengono applicati in ogni esempio:

URI per l'insieme di progetti team: http://AdventureWorksServer:8080/AWTeam/Collection1
Nome del campo elemento di lavoro: AdventureWorks.Field
Codifica predefinita: UTF-8

Elencare i campi

Nel comando seguente vengono visualizzate le informazioni riguardanti ogni campo definito per Collection1 nel server AdventureWorksServer:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Il seguente comando consente di visualizzare le informazioni per il campo AdventureWorks.Field specificato utilizzato da Collection1.

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Nel comando seguente vengono visualizzati tutti i campi che Collection1 non utilizza:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

Rinominare un campo

Il seguente comando modifica in NewFieldName per Collection1 il nome descrittivo del campo AdventureWorks.Field a cui si fa riferimento.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

Modificare il rapporto come valore per un campo

Il seguente comando imposta la possibilità di segnalare il tipo del campo AdventureWorks.CreatedOn di tipo DateTime su dimension. I dati di questo campo vengono immessi nel data warehouse e nei database di Analysis Services in modo da potere essere utilizzati per filtrare i rapporti.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

Il seguente comando imposta la possibilità di segnalare il tipo del campo AdventureWorks.Field di tipo Double su measure. Tutte le misure vengono aggregate come somma.

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

Abilitare la sincronizzazione di un campo nome personalizzato

Nel comando seguente viene abilitata la sincronizzazione per il campo di elemento di lavoro AW.CustomerName definito per Collection1 nel AdventureWorksServer.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

Eliminare un campo

Il seguente comando elimina il campo AdventureWorks.Field da Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Vedere anche

Condividi tramite