Personalizzazione di categorie per tipi di elemento di lavoro

È possibile gestire le categorie per i tipi di elementi di lavoro definiti per un progetto team tramite i seguenti comandi witadmin:

  • exportcategories: Esporta la definizione XML di categorie definita in un server che esegue Team Foundation Server.

  • importcategories: consente di importare un file di definizione XML del tipo di elemento di lavoro in un progetto team su un server che esegue Team Foundation Server. 

    Se una categoria con lo stesso nome già esiste, questo comando sovrascrive la definizione esistente. Se il tipo di elemento di lavoro non esiste già, questo comando crea una nuova categoria.

L'utilità della riga di comando witadmin si trova in Unità>:\Programmi\Microsoft Visual Studio 10.0\Common7\IDE nel computer client che esegue Team Explorer.

Nota

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

Autorizzazioni necessarie

Per il progetto team in cui sono definiti i tipi di elemento di lavoro, è necessario disporre del set di autorizzazioni seguente:

  • Per esportare categorie dei tipi di elementi di lavoro, è necessario essere un membro del gruppo Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti.

  • Per importare categorie di tipi di elementi di lavoro, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o 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 e scegliere Esegui come amministratore. Per ulteriori informazioni, visitare il sito Web Microsoft Controllo account utente (la pagina potrebbe essere in inglese).

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding] 

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.

/p:Project

Il nome del progetto team dal quale vengono esportate o nel quale vengono importate le categorie.

/f:NomeFile

Percorso e nome del file di definizione XML contenente le categorie da esportare o importare. Se si omette questo parametro quando si utilizza il comando exportcategories, il comando elenca le categorie nella finestra del Prompt dei comandi.

/e:Codifica

Il nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà utilizzata per esportare o importare i dati XML. Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7). Se si omette questo parametro, witadmin tenta di rilevare la codifica e se il rilevamento non riesce, witadmin utilizza UTF-8.

/? oppure help

Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

L'importazione di un file di categorie comporta la creazione di categorie se queste non sono già esistenti. Se le categorie esistono già, il comando witadmin importcategories avverte l'utente che l'elenco corrente sarà sovrascritto. È possibile scrivere un programma personalizzato per aggiornare un set di categorie esistente oppure è possibile aggiornare le categorie manualmente con i dati nuovi.

Per ulteriori informazioni del file XML di categorie, vedere Informazioni di riferimento sullo schema di definizione delle categorie.

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 progetto: AdventureWorks

  • Nome del file di input o di output: myCategories.xml

  • Codifica predefinita: UTF-8

Elencare le categorie dei tipi di elementi di lavoro

Il comando seguente consente di elencare le categorie del tipo di elemento di lavoro definite per il progetto AdventureWorks.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks 

Esportare le categorie di tipo di elemento di lavoro

Il comando seguente consente di esportare le categorie del tipo di elemento di lavoro definite per il progetto AdventureWorks nel file XML myCategories.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml 

Importare le categorie dei tipi di elementi di lavoro

Nell'esempio seguente vengono importate le categorie dal file XML myCategories nel progetto AdventureWorks.

witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml 

Vedere anche

Altre risorse

Raggruppamento dei tipi di elementi di lavoro in categorie

Utilizzo delle categorie dei tipi di elementi di lavoro

witAdmin: amministrazione di oggetti per la verifica degli elementi di lavoro