Importar e exportar categorias [witadmin]
Você pode importar e exportar categorias definidas para um projeto de equipe usando os seguintes 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 do tipo de item de trabalho para 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, este comando cria uma nova categoria.
Para saber mais sobre as categorias padrão e como eles são usados, vá aqui.
Para executar a ferramenta da linha de comandos witadmin, abra uma janela do Prompt de Comando em que Visual Studio ou Team Explorer esteja instalado e insira:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
Em uma edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%.
Dica
Você pode criar e modificar as categorias usando o Editor de processo, uma poderosa ferramenta para Visual Studio.Não há suporte para essa ferramenta de energia.Para obter mais informações, consulte a seguinte página no site da Microsoft: Team Foundation Server Power Tools.
Requisitos
Projeto de equipe para o qual as categorias são definidas, você deve ter as seguintes permissões definido:
Para exportar categorias de tipos de item de trabalho, você deve ter seu exibir informações de nível de projeto permissão definida como permitir.
Para importar as categorias de tipos de item de trabalho, você deve ser um membro do administradores do projeto segurança de grupo ou ter o editar informações de nível de projeto permissão definida como permitir.
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 o URI da coleção de projeto de equipe. O formato do URI é o seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName Se nenhum diretório virtual for usado, então o formato do URI será o seguinte: http://ServerName:Port/CollectionName. |
/p:Project |
O nome do projeto da equipe de que as categorias são exportadas ou para que 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 do Prompt de comando. |
/e:Codificação |
O nome de um formato de codificação .NET Framework 2,0. 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. |
/? ou help |
Exibe ajuda sobre o comando na janela Prompt de comando. |
Comentários
Importar um arquivo de categorias cria as categorias se eles ainda não existir. Se já existirem categorias, o witadmin importcategories comando avisará que a lista atual será substituída. Você pode escrever seu próprio programa para atualizar um conjunto de categorias existentes, ou você pode atualizar as categorias com novos dados.
Importante
As alterações feitas às categorias podem afetar a configuração do processo.Consulte Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.
Para obter informações sobre a estrutura do arquivo XML categorias, consulte Referência a elementos XML de categorias.
Exemplos
A menos que especificado de outra forma, os seguintes valores se aplicam a cada exemplo:
URI da coleção do projeto de equipe: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nome do projeto: AdventureWorks
Entrada ou saída nome do arquivo: myCategories.xml
Codificação padrão: UTF-8
Lista de categorias
O comando a seguir lista as categorias de tipo de item de trabalho definidas para o projeto AdventureWorks.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks
Adicionar uma categoria para as categorias de tipos ocultos
Adicionar uma categoria para as categorias de tipos ocultos para remover o suporte aos usuários criar tipos de item de trabalho nessa categoria.
Exporte o arquivo de definição de categorias para o seu projeto de equipe.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xmlAbra o arquivo de categorias em seu editor de texto preferido e localize o CATEGORY elemento para o "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>Adicionar uma WORKITEMTYPE elemento que especifica o nome amigável do tipo de item de trabalho que você deseja adicionar.
Por exemplo, a sintaxe a seguir adiciona o tipo de item de trabalho personalizados de "Compilação de integração" para a categoria de tipos ocultos.
<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>Importe o arquivo de definição de categorias ao seu projeto de equipe.
witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml
Consulte também
Conceitos
Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe