Configuração do processo de importação e exportação

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você personaliza a configuração do processo para modificar a exibição das ferramentas Agile do portal da web. Algumas ferramentas adicionais exigem que você mapeie estados de fluxo de trabalho para mapeamentos de metaestado.

Para gerenciar a configuração do processo para um projeto, use a ferramenta de witadmin linha de comando para exportar e importar o arquivo de definição XML de configuração do processo. Para saber mais sobre a configuração do processo, consulte ProcessConfiguration.

• exportprocessconfig: Exporta a definição de configuração do processo para um arquivo XML ou para a janela do prompt de comando.
• importprocessconfig: Importa o arquivo XML de definição de configuração do processo.

Executar a ferramenta de linha de witadmin comando

Para executar a ferramenta de linha de comando, abra uma janela de prompt de comando onde o witadmin Visual Studio está instalado. A witadmin ferramenta de linha de comando é instalada com qualquer versão do Visual Studio. Você pode acessar essa ferramenta instalando a versão gratuita do Visual Studio Community ou do Visual Studio Team Explorer.

Para o Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Enterprise ou Professional no lugar de Community, dependendo da versão instalada.

Para o Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Enterprise ou Professional no lugar de Community, dependendo da versão instalada.

Para Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Professional ou TeamExplorer no lugar de Enterprise, dependendo da versão instalada.

Numa edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%. Você pode instalar o Visual Studio Community (que fornece acesso ao Team Explorer) ou o Visual Studio Team Explorer 2017 gratuitamente.

Pré-requisitos

• Para exportar definições de configuração de processo, você deve ser um usuário válido do projeto ou coleção.
• Para importar definições de configuração de processo, você deve ser membro dos seguintes grupos de segurança: Administradores do Team Foundation ou Administradores de Projeto.

Para obter mais informações, consulte Alterar as permissões ao nível da coleção de projetos.

Sintaxe

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

Parâmetros

Observações

A instalação da versão mais recente do Azure DevOps atualiza projetos existentes. Se você estiver atualizando um projeto atualizado, consulte Configurar recursos após uma atualização.

Se você encontrar problemas para acessar planos de teste ou pacotes de teste existentes após uma atualização, consulte Atualizações manuais para dar suporte ao gerenciamento de testes.

Exemplos

Os seguintes valores se aplicam em cada exemplo:

• URL da coleção: http://AdventureWorksServer:8080/tfs/DefaultCollection
• Projeto: Contoso
• Número da porta para o site do servidor: 8080

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

Você pode adicionar campos para qualquer painel de adição rápida. Por exemplo, o exemplo a seguir adiciona valor comercial ao painel de lista de pendências do produto.

O painel exibe apenas os campos incluídos na FIELDS seção da definição de WIT para o WIT selecionado. Por exemplo, se você selecionar o bug WIT, somente Título será exibido, pois o Valor Comercial não está definido para bugs. Para adicionar outro WIT ao painel, adicione-o à Categoria de requisitos. Consulte Adicionar um tipo de item de trabalho a uma lista de pendências e quadro.

1. Se você não tiver permissões administrativas para seu projeto, obtenha-as.

2. Abra uma janela de prompt de comando de acordo com as instruções fornecidas em Como executar a ferramenta de linha de comando witadmin. Por exemplo:

   cd %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
   

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

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

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

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

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

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

   Gorjeta

   • Você pode procurar o nome de referência para um campo usando esse índice.
   • Adicione todos os campos obrigatórios para tipos de item de trabalho definidos para a Categoria de Requisitos. Dessa forma, você evita ter que abrir o formulário de item de trabalho para preenchê-los quando você adiciona itens de lista de pendências através do painel.

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

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

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

Atualizar mapeamentos de metaestado para oferecer suporte ao Test Manager

Se você personalizar a WORKFLOW seção do plano de teste ou conjunto de testes, deverá mapear os estados para metaestados.

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

Fluxo de Trabalho

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

Mapeamentos de metaestados

<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ê modificar o fluxo de trabalho do conjunto de testes, precisará fazer uma atualização semelhante se quiser mapear novos estados. Você o adicionaria dentro de uma TestSuiteWorkItems seção. Consulte ProcessConfiguration.

Perguntas e Respostas

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

R: Ao adicionar ou remover estados de fluxo de trabalho para os seguintes tipos de item de trabalho, você deve considerar a atualização da configuração do processo para adicionar ou remover mapeamentos de metaestado correspondentes.

• Tipos de item de trabalho que pertencem à Categoria de Requisito ou Categoria de Tarefa: Os mapeamentos de metaestado suportam a exibição das ferramentas de planejamento Agile.

• Tipos de item de trabalho que pertencem à Categoria de Bug: Mapeamentos de metaestado para suportar a ferramenta My Work (projetos ágeis e baseados em CMMI).

• Plano de teste e pacote de teste: as atualizações para o fluxo de trabalho desses tipos de item de trabalho devem ser mapeadas somente quando você dá suporte aos membros da equipe que se conectam ao Azure DevOps a partir de uma versão do Test Manager baseada no Visual Studio 2013.2 ou versão anterior.

  Atualize os mapeamentos de metaestado se você receber um aplicativo detetado um erro de falha inesperada quando você se conectar ao seu projeto.

  

Como resolvo erros de configuração do processo?

R: Ao fazer uma das seguintes alterações em um projeto, você precisará atualizar as definições para o tipo de item de trabalho, categorias ou configuração de processo. Para evitar erros, faça sempre as alterações nesta ordem: (1) tipos de item de trabalho, (2) categorias e (3) configuração do processo.

P: Você quer trabalhar com duas ou mais listas de pendências de portfólio?

R: A experiência padrão suporta um nível de lista de pendências de portfólio. Você pode adicionar até cinco níveis, conforme descrito em Adicionar listas de pendências de portfólio às ferramentas Agile.

P: Deseja adicionar ou alterar os tipos de item de trabalho que aparecem no quadro de tarefas ou na lista de pendências do produto?

R: Se você adicionou um tipo de item de trabalho personalizado e deseja adicioná-lo à lista de pendências ou ao quadro de tarefas, você pode. Você simplesmente não pode fazê-los aparecer em ambos os lugares. Saiba como lendo Adicionar tipos de item de trabalho a listas de pendências e quadros.

Artigos relacionados

• Configurar recursos após uma atualização
• Referência de elemento XML de controle
• Alterar o layout do formulário de item de trabalho
• Editar uma definição de tipo de item de trabalho para adicionar conteúdo da Web a um formulário de item de trabalho
• Personalizar a sua experiência de acompanhamento de trabalho
• Índice do campo dos itens de trabalho
• witAdmin: Personalize e gerencie objetos para acompanhar o trabalho