Condividi tramite

Importare ed esportare categorie [witadmin]

  • Articolo

È possibile importare ed esportare le categorie definite per un progetto team usando i seguenti comandi witadmin:

  • exportcategories: consente di esportare la definizione XML di categorie definite in un server in cui è eseguito Team Foundation Server.

  • importcategories:  importa un file di definizione XML del tipo di elemento di lavoro in un progetto team in un server in cui è eseguito Team Foundation Server. 

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

Per altre informazioni sulle categorie predefinite e sul metodo di utilizzo, vedere qui.

Per eseguire lo strumento da riga di comando witadmin, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.

Nota

È possibile creare e modificare categorie tramite l'Editor di processo, uno strumento avanzato per Visual Studio.Questo power tool non è supportato.Per altre informazioni, vedere la pagina seguente nel sito Web Microsoft: Power Tools di Team Foundation Server.

Requisiti

Per il progetto team per il quale sono definite le categorie, è necessario disporre del set di autorizzazioni seguente:

  • Per esportare categorie di tipi di elemento di lavoro, è necessario disporre dell'autorizzazione Visualizza informazioni a livello di progetto impostata su Consenti.

  • Per importare categorie di tipi di elementi di lavoro, è necessario essere un membro del gruppo di sicurezza Project Administrators o disporre dell'autorizzazione Modifica informazioni a livello di progetto impostata su Consenti.

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

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

Parametri

Parametro

Descrizione

/collection:CollectionURL

Specifica l'URI della raccolta di progetti team. Il formato dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta

Se non viene usata alcuna directory virtuale, il formato dell'URI sarà il seguente:

http://NomeServer:Porta/NomeRaccolta.

/p:Project

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 usa il comando exportcategories, viene visualizzato l'elenco delle categorie nella finestra del prompt dei comandi.

/e:codifica

Nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà usata per esportare o importare i dati XML. Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7). Se si omette questo parametro, verrà tentato da parte di witadmin di rilevare la codifica. Se il rilevamento non riesce, verrà usata da witadmin la codifica 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 delle categorie che non esistono già. Se le categorie sono già presenti, verrà visualizzato tramite il comando witadmin importcategories un avviso di sovrascrittura dell'elenco corrente. È possibile scrivere un programma personalizzato per aggiornare un set di categorie esistente oppure è possibile aggiornare personalmente le categorie inserendo nuovi dati.

Importante

Le modifiche apportate alle categorie possono influire sulla configurazione del processo.Vedere Configurare e personalizzare gli strumenti di pianificazione Agile per il progetto team.

Per informazioni sulla struttura del file XML di categorie, vedere Riferimento agli elementi XML delle categorie.

Esempi

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

  • URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nome progetto: AdventureWorks

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

  • Codifica predefinita: UTF-8

Creare un elenco delle categorie

Mediante il comando seguente vengono elencate le categorie del tipo di elemento di lavoro definite per il progetto AdventureWorks.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

Aggiungere una categoria alle categorie tipi nascosti

Aggiungere una categoria alle categorie Tipi nascosti per impedire agli utenti di creare tipi di elemento di lavoro in quella categoria.

  1. Esportare il file di definizione per le categorie per il progetto team.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

  2. Aprire il file di categorie nell'editor di testo preferito e individuare l'elemento CATEGORY per la "Hidden Types Category".

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
</CATEGORY>

  3. Aggiungere un elemento WORKITEMTYPE che specifica il nome descrittivo del tipo di elemento di lavoro che si desidera aggiungere.

    Ad esempio, la sintassi seguente aggiunge il tipo di elemento di lavoro personalizzato "Integration Build" alla categoria tipi nascosti.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
   <WORKITEMTYPE name="Integration Build" />
</CATEGORY>

  4. Importare il file di definizione per le categorie nel progetto team.

    witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Vedere anche

Concetti

Configurare e personalizzare gli strumenti di pianificazione Agile per il progetto team

Altre risorse

Utilizzare le categorie per raggruppare tipi di elementi di lavoro