Personalizando as categorias de tipos de Item de trabalho

  • Artigo

Você pode gerenciar as categorias de tipos de item de trabalho definidos para um projeto de equipe usando o seguinte witadmin comandos:

  • exportcategories: Exporta a definição XML das categorias definidas em um servidor que executa o Team Foundation Server.

  • importcategories: Importa um arquivo de definição de XML para tipo de item de trabalho em um projeto de equipe em um servidor que executa o Team Foundation Server. 

    Se uma categoria com o mesmo nome já existir, este comando substitui a definição existente. Se o tipo de item de trabalho ainda não existir, esse comando cria uma nova categoria.

O witadmin o utilitário de linha de comando está localizado na da unidade:\Arquivos de Programas\Microsoft 10.0\Common7\IDE de Visual Studio no computador cliente que executa o Team Explorer.

ObservaçãoObservação

Você pode criar e modificar as categorias usando o Editor de processo, uma ferramenta de alimentação para Visual Studio. Esta ferramenta de energia não é suportada. Para obter mais informações, consulte a seguinte página no site da Microsoft: Team Foundation Server Power Tools em abril de 2010.

Permissões necessárias

Para o projeto de equipe, onde são definidos os tipos de item de trabalho, você deve ter as seguintes permissões definidas:

  • Para exportar as categorias dos tipos de item de trabalho, você deve ser um membro da leitores do grupo ou ter sua Exibir itens neste aceno de trabalhoe a permissão definida como Permitir

  • Para importar as categorias dos tipos de item de trabalho, você deve ser um membro da Os administradores do Team Foundation o grupo de segurança ou o Administradores de projeto o grupo de segurança.

For more information, see Permissões de Team Foundation Server and Team Foundation Server de grupos, permissões e funções.

ObservaçãoObservação

Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe clique em Executar como administrador. Para obter mais informações, consulte o site da Microsoft: O controle de conta de usuário.

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

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

Parâmetros

Parameter

Description

/collection:CollectionURL

Especifica o URI da coleção de projeto de equipe. O formato para o URI é o seguinte: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta

Se nenhum diretório virtual é usado, o formato para o URI é o seguinte:

http: / /Nome_do_servidor: port / NomeDaColeta.

/p:Project

O nome do projeto da equipe, as categorias são exportadas ou para as categorias são importadas.

/f:Nome de arquivo

O caminho e o nome do arquivo de definição XML que contém as categorias a serem exportados ou importados. Se você omitir esse parâmetro quando você usa o exportcategories de comando, o comando lista as categorias na janela de Prompt de comando.

/e:Codificação

O nome de um .NET Framework 2.0 codificação formato. A codificação especificada será usada para exportar ou importar os dados XML. Por exemplo, /e:utf-7 Especifica a codificação Unicode (UTF-7). Se você omitir esse parâmetro, witadmin tenta detectar a codificação, e se a detecção de falha, witadmin usa UTF-8.

/?ouhelp

Exibe ajuda sobre o comando na janela do Prompt de comando.

Comentários

Importando um arquivo de categorias cria categorias se eles ainda não existir. Se já existirem categorias, o witadmin importcategories comando irá avisá-lo que a lista atual será sobrescrita. Você pode escrever seu próprio programa de atualização de um conjunto de categorias existentes ou você pode atualizar as categorias com novos dados.

Para obter informações sobre a estrutura do arquivo XML categorias, consulte Referência de esquema de definição de categorias.

Examples

A menos que especificado em contrário, os valores a seguir aplicam-se em cada exemplo:

  • URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/AWTeam/Collection1

  • Nome do projeto: AdventureWorks

  • Entrada ou saída nome de arquivo: myCategories.xml

  • Padrão de codificação: UTF-8

Categorias de tipo de Item de trabalho de lista

O comando a seguir lista as categorias de tipo de item de trabalho definidas para o projeto AdventureWorks.

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

Exportar as categorias do tipo de Item de trabalho

O comando a seguir exporta as categorias de tipo de item de trabalho definidas para o projeto AdventureWorks ao arquivo XML myCategories.

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

Importar as categorias do tipo de Item de trabalho

O exemplo a seguir importa categorias do arquivo XML myCategories para o projeto AdventureWorks.

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

Consulte também

Outros recursos

O agrupamento de tipos de Item de trabalho em categorias

Trabalhar com categorias de tipo de Item de trabalho

witAdmin: Administrando objetos para controlar os itens de trabalho