Importar e exportar configuração do processo [witadmin]

Você personaliza a configuração do processo para mudar a exibição das páginas da ferramenta de planejamento Agile que visualiza usando o Team Web Access (TWA). Algumas ferramentas adicionais exigem mapear estados de fluxo de trabalho para mapeamentos de metaestado.

Para uma visão geral de como personalizar as páginas da ferramenta de planejamento Agile, veja Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.

Dica

Se receber uma mensagem de erro TF400917, é porque ocorreu uma configuração inválida no TWA.Importe novamente o arquivo de configuração do processo para seu projeto de equipe usando witadmin importcommonprocessconfig.Você receberá as mensagens necessárias para resolver o erro.

Para gerenciar a configuração do processo de um projeto de equipe, use a ferramenta de linha de comando witadmin para exportar e importar o arquivo de definição XML da configuração do processo. Para saber sobre a configuração do processo, veja Referência de elemento XML da configuração de processo.

• exportprocessconfig: Exporta a definição da configuração do processo para um arquivo XML ou para a janela de Prompt de Comando.

• importprocessconfig: Importa o arquivo XML de definição da configuração do processo.

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%.

Requisitos

• Você tem que ser um usuário válido do projeto de equipe ou da coleção para exportar as definições de configuração do processo.

• Para importar as definições de configuração do processo, você tem que ser membro dos seguintes grupos de segurança: Administradores do Team Foundation ou Administradores do Projeto.

Para obter mais informações, consulte Referência de permissões para o Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Parâmetros

Parâmetro	Descrição
/collection:CollectionURLx	Obrigatório. Especifica a URL da coleção. Você tem que especificar o URI no seguinte formato: http://ServerName:Port/VirtualDirectoryName/CollectionName Se não especificar um diretório virtual, então especifique o URI no seguinte formato: http://ServerName:Port/CollectionName.
/p:ProjectName	Obrigatório. Especifica o projeto de equipe para onde deseja exportar ou importar a configuração do processo. Esse projeto de equipe tem que ser definido na coleção especificada usando o parâmetro /collection. Não é necessário especificar um projeto de equipe ao especificar a opção /v.
/f:FileName	O caminho e o nome do arquivo de definição XML da configuração do processo, para exportar ou importar. Dica Talvez você não tenha permissões para certas pastas, caso o computador cliente esteja executando o Windows Vista.A tecnologia de virtualização de registro redireciona o arquivo exportado e o salva no repositório virtual, automaticamente, caso tente exportar a lista global para um local para o qual você não tenha permissões.Para saber mais, veja as páginas a seguir no site da Microsoft: Virtualização de registro e Common file and registry virtualization issues in Windows Vista.Para evitar esse redirecionamento, exporte o arquivo para um local em que tenha permissões.
/e:Encoding	Opcional. 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 codificação Unicode (UTF-7). Se omitir esse parâmetro, o witadmin tenta detectar a codificação e, caso não consiga, usa UTF-8.
/v	Opcional. Valida o XML que define a configuração do processo, mas não importa o arquivo de definição.
/? ou help	Exibe ajuda sobre o comando na janela Prompt de comando.

Comentários

Dica

Instalando projetos de equipe existentes nas atualizações do VS TFS 2013.Eles usarão o arquivo de configuração do processo, que combina os arquivos de configuração do Agile com os de configuração comum, compatíveis com o TFS 2012.Os comandos witadmin a seguir, e seus arquivos de configuração correspondentes, não foram aprovados:

• exportagileprocessconfig

• exportcommonprocessconfig

• importagileprocessconfig

• importcommonprocessconfig

Se estiver atualizando um projeto de equipe atualizado, veja Configurar recursos após uma atualização do TFS.

Se encontrar problemas para acessar planos de teste existentes ou pacotes de teste após um upgrade para o TFS 2013.3, veja Atualizar manualmente um projeto de equipe para oferecer suporte ao gerenciamento de testes.

Exemplos

Os valores a seguir se aplicam a todos os exemplos:

• URL para a coleção: http://AdventureWorksServer:8080/tfs/DefaultCollection

• Projeto de equipe: Contoso

• Número da porta do site do servidor: 8080

Para adicionar um campo ao painel de adição rápida

É possível adicionar campos para qualquer painel de adição rápida. Por exemplo, o exemplo a seguir adiciona o Valor Comercial para o painel da lista de pendências do produto.

O painel só exibe campos incluídos na seção FIELDS de definição do WIT para o WIT selecionado. Por exemplo, se selecionar o bug WIT, então apenas o Título será exibido, já que o Valor Comercial não está definido para bugs. Para adicionar outro WIT ao painel, você o adiciona à Categoria de Requisitos como descrito aqui.

1. Se não tiver permissões administrativas para seu projeto de equipe, consiga-as.

2. Abra uma janela do Prompt de Comando onde o Visual Studio ou o Team Explorer esteja instalado e digite:

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

   Em uma edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%. É possível baixar o Team Explorer gratuitamente.

3. Exporte o arquivo de configuração do processo.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

   Um exemplo de CollectionURL é http://MyServer:8080/tfs/TeamProjectCollectionName.

4. Adicione o nome de referência do campo à seção AddPanel.

   Por exemplo, a sintaxe a seguir adiciona o elemento Prioridade ao painel.

   <AddPanel>
      <Fields>
         <Field refname="System.Title" />
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />
      </Fields>
   </AddPanel>
   

   Dicas:

   • É possível consultar o nome da referência para um campo usando este índice.

   • Adicione todos os campos necessários para tipos de item de trabalho definidos para a Categoria de Requisitos. Dessa maneira, você não precisa abrir o formulário de item de trabalho para preenchê-lo ao adicionar itens da lista de pendências por meio do painel.

5. Importe o arquivo de configuração do processo.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. Atualize a página da lista de pendências para visualizar o painel atualizado.

Atualizar mapeamentos de metaestado para dar suporte a o Test Manager

Se você personalizar a seção WORKFLOW do plano de teste ou pacote de testes, deve mapear os estados para metaestados. Isso dá suporte a clientes Test Manager que estão no Visual Studio 2013.2 ou versões anteriores.

No exemplo a seguir, o fluxo de trabalho de plano de teste foi atualizado para usar os estados de Design, Teste e Aprovado. Para dar suporte a compatibilidade com versões anteriores, o TestPlanWorkItems é adicionado à seção ProjectProcessConfiguration da definição de configuração de processo.

FLUXO DE TRABALHO

Mapeamentos de metaestado

<WORKFLOW>       <STATES>         <STATE value="Design" />         <STATE value="Testing" />         <STATE value="Signed Off" />       </STATES>       <TRANSITIONS>         <TRANSITION from="" to="Design">           <REASONS>             <DEFAULTREASON value="New test plan" />           </REASONS>         </TRANSITION>      <TRANSITION from="Design" to="Testing">           <REASONS>             <DEFAULTREASON value="Authoring complete" />           </REASONS>         </TRANSITION>             <TRANSITION from="Testing" to="Signed Off">           <REASONS>             <DEFAULTREASON value="Signed Off testing" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Design">           <REASONS>             <DEFAULTREASON value="Reactivating to authoring phase" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Testing">           <REASONS>             <DEFAULTREASON value="Reactivating to run tests" />           </REASONS>         </TRANSITION>         <TRANSITION from="Testing" to="Design">           <REASONS>             <DEFAULTREASON value="Back to authoring" />           </REASONS>         </TRANSITION>       </TRANSITIONS>     </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">     <States>       <State type="InProgress" value="Design" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Signed Off" />     </States>   </TestPlanWorkItems> <TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">     <States>       <State type="Proposed" value="In Planning" />       <State type="InProgress" value="In Progress" />       <State type="Complete" value="Completed" />     </States>   </TestSuiteWorkItems>

Se você mudar o fluxo de trabalho do pacote de testes, será preciso realizar uma atualização similar se desejar mapear novos estados. Você adicionaria dentro de uma seção do TestSuiteWorkItems. Consulte Referência de elemento XML da configuração de processo.

Perguntas e respostas

P: Quais personalizações posso fazer e ainda assim usar o assistente Configurar Recursos para atualizar meu projeto de equipe após uma atualização do TFS?

R: Você pode personalizar o painel de adição rápida. O assistente Configurar Recursos atualizará seus projetos de equipe e você terá acesso aos recursos mais recentes.

Outras mudanças podem exigir a execução de algumas operações manuais ao atualizar seu projeto de equipe. Para aprender sobre quais personalizações pode fazer com segurança e quais evitar, veja Personalizar a experiência de acompanhamento de trabalho: antes que você personalize, considere as implicações de manutenção e atualização.

P: Quando eu preciso mapear estados de fluxo de trabalho para metaestados?

R: Ao adicionar ou remover estados de fluxo de trabalho para os WITs a seguir, deve considerar atualizar a configuração de processo para adicionar ou remover mapeamentos de metaestado correspondentes.

• WITs que pertencem à categoria de requisito ou à categoria de tarefa: mapeamentos de metaestado dão suporte à exibição de ferramentas de planejamento Agile.

• WITs que pertencem à categoria de bug: mapeamentos de metaestado para dar suporte à ferramenta Meu Trabalho (projetos de equipe baseados em Agile e CMMI).

• Plano de teste e Conjunto de testes: atualizações ao fluxo de trabalho desses WITs devem ser mapeadas apenas quando os membros da equipe de suporte conectando-se ao TFS de uma versão do Test Manager baseada em Visual Studio 2013.2 ou versão anterior.

  WITs de Plano de teste e Conjunto de testes estão disponíveis apenas com o upgrade para o TFS 2013.3, disponível a partir desta página de download.

  Atualize os mapeamentos de metaestado se receber um erro de Aplicativo detectou uma falha inesperada ao conectar-se ao projeto de equipe.

  

Como resolver os erros de configuração de processo?

R: Ao fazer uma das seguintes alterações a um projeto de equipe, será preciso atualizar as definições para o WIT, categorias ou configuração de processo. Para evitar erros, sempre faça as alterações nesta ordem: (1) WITs, (2) categorias e (3) configuração de processo.

Personalização	Atualizar ou verificar a definição de WIT	Atualizar ou verificar a definição de configuração de processo
Adicionar um WIT à categoria de requisitos (Um WIT pode pertencer à categoria de requisitos ou à categoria de tarefas, mas não a ambas.)	Para incluir os seguintes campos: Prioridade da lista de pendências (Scrum) ou classificação da pilha (Agile ou CMMI) (deve combinar com o valor de campo atribuído a type=Order no arquivo de configuração de processo) Esforço (Scrum), Pontos de História (Agile) ou Tamanho (CMMI) (deve combinar com o valor de campo atribuído a type=Effort no arquivo de configuração de processo) Caminho de área ou valor de campo atribuído a type=Team no arquivo de configuração de processo Todos os campos incluídos na seção AddPanel do arquivo de configuração de processo. Os campos devem ser definidos dentro da seção FIELDS, mas não precisam ser incluídos dentro da seção FORM.	Para conter os mapeamentos de metaestado necessários: Mapeie o início do estado de cada fluxo de trabalho para type="Proposed" Mapeie o estado de cada fluxo de trabalho intermediário que deseja que apareça no painel Kanban para type="InProgress" Mapeie o fim do estado de cada fluxo de trabalho para type="Complete" É possível ter apenas um Estado mapeado para type="Complete" Para conter uma entrada para definir os códigos de cor associados ao WIT. Por exemplo: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />
Mude o fluxo de trabalho de um WIT na categoria de requisitos	N/D	Para conter os mapeamentos de metaestado necessários como descrito acima para adicionar um WIT à categoria de requisitos.
Adicionar um WIT à categoria de tarefas	Para incluir os seguintes campos: Prioridade da lista de pendências (Scrum) ou classificação da pilha (Agile ou CMMI) Atividade (Scrum ou Agile) ou Disciplina (CMMI) (deve combinar com o valor de campo atribuído a type=Activity no arquivo de configuração de processo) Trabalho restante (deve combinar com o valor de campo atribuído a type=RemainingWork no arquivo de configuração de processo) Caminho de área ou valor de campo atribuído a type=Team no arquivo de configuração de processo (Opcional) Trabalho original e trabalho concluído (Agile e CMMI apenas)	Para conter os mapeamentos de metaestado necessários: Mapeie o início do estado de cada fluxo de trabalho para type="Proposed" Mapeie o estado de cada fluxo de trabalho intermediário que deseja que apareça no painel de tarefas para type="InProgress" Mapeie o fim do estado de cada fluxo de trabalho para type="Complete" É possível ter apenas um Estado mapeado para type="Complete" Para conter uma entrada para definir os códigos de cor associados ao WIT. Por exemplo: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
Mude o fluxo de trabalho de um WIT na categoria de tarefas	N/D	Para conter os mapeamentos de metaestado necessários como descrito acima para adicionar um WIT à categoria de tarefas.
Adicionar um WIT à categoria de bug (Agile e CMMI apenas) Mudar o fluxo de trabalho de um WIT na categoria de bug (Agile e CMMI apenas)	N/D	Para conter os mapeamentos de metaestado necessários: Mapeie o início do estado de cada fluxo de trabalho para type="Proposed" Mapeie cada estado de fluxo de trabalho intermediário que deseja que apareça para Meu Trabalho para type="InProgress" Mapeie o fim do estado de cada fluxo de trabalho para type="Complete" É possível ter apenas um Estado mapeado para type="Complete" Para saber mais, veja Suporte à atualização de status de bug usando Meu trabalho.
Remova um WIT da categoria de requisitos ou de tarefas	N/D	Para remover qualquer mapeamento de metaestado associado apenas àqueles WIT
Remover um WIT de um projeto de equipe	Para remover o WIT do arquivo de categorias.	Para remover qualquer mapeamento de metaestado associados apenas ao WIT removido e ao elemento WorkItemColor que define os códigos de cor para o WIT removido.

P: Como posso personalizar outras funções que aparecem nas ferramentas de planejamento do Agile no TWA?

R: Algumas personalizações podem ser feitas por meio da interface do usuário. Outros requerem a configuração do processo de edição ou de outros objetos de projeto de equipe. Para obter uma visão geral, veja Configurar e personalizar ferramentas de planejamento do Agile para um projeto de equipe.

P: Você quer trabalhar com duas ou mais reservas de portfólio?

R: A experiência padrão oferece suporte a um nível de retorno de portfólio. Você pode adicionar até cinco níveis como descrito em Adicionar uma lista de pendências ao Prático gerenciamento de portfólio.

P: Você deseja adicionar ou alterar os WITs que aparecem em seu painel de tarefas ou na lista de pendências do produto?

R: Se você adicionou um WIT (tipo de item de trabalho) personalizado, é possível adicioná-lo à lista de pendências ou ao painel de tarefas. Você não pode deixar que eles apareçam nos dois lugares. Saiba como lendo Adicionar bugs ao painel de tarefas ou à lista de pendências.