Personalizar as categorias de tipos de itens de trabalho

Você pode gerenciar as categorias para os tipos de itens de trabalho definidos para um projeto de equipe usando os seguintes comandos de witadmin :

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

• importcategories:  Importa um arquivo de definição de XML de tipo de item de trabalho em um projeto de equipe em um servidor que executa 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 já não existir, este comando cria uma nova categoria.

Para executar a ferramenta de linha de comando witadmin , abra uma janela de prompt de comando onde Visual Studio ou Team Explorer sejam instalados e insira:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Em uma edição de 64 bits do windows, substitua %programfiles% com o %programfiles x (%).

Observação
Você pode criar e modificar categorias usando o editor do processo, uma ferramenta avançada para Visual Studio.Essa ferramenta avançada não é suportada.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas eléctricas do Team Foundation Server.

Requisitos

Para a equipe do projeto para o qual as categorias são definidas, você deve ter as permissões definidas seguintes:

• Para exportar categorias de tipos de item de trabalho, você deve ter seu conjunto de permissões de Exibir informações de nível de projeto a Permitir.

• Para importar categorias de tipos de item de trabalho, você deve ser um membro do grupo de segurança Administradores de projeto ou ter o conjunto de permissões de Informações de nível de projeto de edição a Permitir.

Para obter mais informações, consulte Team Foundation Permissões do servidor e Team Foundation Funções, permissões e grupos do servidor padrão.

Observação

Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra o menu de atalho de Prompt de comando , e escolha Executar como administrador.Para obter mais informações, consulte o site da Microsoft: 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

Parâmetro	Descrição
/collection:CollectionURL	Especifica a URL a coleção de projeto de equipe.o formato para o URI é o seguinte: http:ServerName: porta/VirtualDirectoryName/CollectionName/ Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http: /ServerName: porta/CollectionName.
/p:Project	O nome do projeto de equipe que as categorias são exportadas ou a qual as categorias são importadas.
/f:nome de arquivo	O caminho e o nome do arquivo de definição de XML que contém as categorias a ser exportadas ou importado.Se você omitir este parâmetro quando você usar o comando de exportcategories , listas de comando as categorias na janela do prompt de comando.
/e:Codificação	o nome de .NET Framework 2.0 que codifica o formato.A codificação especificada será usada para importar ou exportar os dados XML.Por exemplo, /e:utf-7 especificar a codificação Unicode (UTF-7).Se você omitir este parâmetro, witadmin tenta detectar a codificação, e se a detecção falhar, witadmin usa UTF-8.
/? ou help	Exibe ajuda sobre o comando na janela do prompt de comando.

Comentários

Importar um arquivo de categorias cria as categorias se já não existe.Se as categorias já existirem, o comando de witadmin importcategories adverti-lo-á que a lista atual será substituída.Você pode escrever seu próprio programa para atualizar um dataset existente de categorias, ou você pode atualizar as categorias você mesmo com novos dados.

Importante
As alterações feitas às categorias podem afetar a configuração do processo.Consulte Personalizar a lista de pendências e as páginas do quadro usando a configuração do processo.

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

Exemplos

Salvo indicação caso contrário, os seguintes valores se aplicam em cada exemplo:

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

• Nome do projeto: AdventureWorks

• Nome de arquivo de entrada ou saída: myCategories.xml

• Codificação padrão: UTF-8

Categorias de tipo de item de trabalho de lista

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

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

Categorias de tipo de item de trabalho de exportação

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

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

Categorias de tipo de item de trabalho de importação

O exemplo a seguir importa categorias do arquivo XML de myCategories ao projeto AdventureWorks.

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

Consulte também

Conceitos

Personalizar a lista de pendências e as páginas do quadro usando a configuração do processo

Outros recursos

Definir categorias para agrupar os tipos de item de trabalho

Referência de elementos das categorias de tipo de item de trabalho

witAdmin: personalizar e gerenciar objetos para monitorar itens de trabalho