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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Importante

Para o modelo de processo XML local, você pode usar witadmin para listar, importar, exportar e modificar um processo para um projeto. Para os modelos de processo XML herdado e hospedado, você só pode usar witadmin para listar e exportar informações do processo. Para obter uma visão geral dos modelos de processo e do que é suportado, consulte Personalizar sua experiência de acompanhamento de trabalho.

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.

Nota

Se receber uma mensagem de erro TF400917, ocorreu uma configuração inválida. Reimporte o arquivo de configuração do processo para seu projeto usando witadmin importprocessconfigo . Você receberá as mensagens necessárias para resolver o erro.

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.

Nota

Para se conectar aos Serviços de DevOps do Azure, recomendamos que você use a versão mais recente do Visual Studio ou da Comunidade do Visual Studio.

Nota

Para se conectar a um servidor local, recomendamos que você use a mesma versão ou posterior do Visual Studio como seu Servidor de DevOps do Azure. Por exemplo, se você se conectar ao Azure DevOps Server 2019, conecte-se ao seu projeto a partir de uma versão do Visual Studio 2019.

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.

Gorjeta

Com o witadmin, você pode importar e exportar arquivos de definição. Outras ferramentas que você pode usar incluem o Editor de processos (requer que você tenha instalado uma versão do Visual Studio). Instale o editor de modelo de processo do Visual Studio Marketplace.

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 permissões no nível da coleção do projeto.

Sintaxe

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

Especifica o URI da coleção de projetos. Por exemplo:

Formato de DevOps do Azure local:http://ServerName:Port/VirtualDirectoryName/CollectionName

Se nenhum diretório virtual for usado, o formato do URI será o seguinte: http://ServerName:Port/CollectionName.

/p:ProjectName

Obrigatório. Especifica o projeto para o qual você deseja exportar ou importar a configuração do processo. Este projeto deve ser definido na coleção que você especificou usando o parâmetro /collection. Não é necessário especificar um projeto ao especificar a /v opção.

/f**:FileName

O caminho e o nome do arquivo de definição XML para a configuração do processo a ser exportado ou importado.

Nota

Se o computador cliente estiver executando o Windows Vista, talvez você não tenha permissões para determinadas pastas. Se você tentar exportar a lista global para um local onde não tenha permissões, a tecnologia de virtualização do Registro redirecionará automaticamente o arquivo exportado e o salvará no repositório virtual. Para obter mais informações, consulte a página Virtualização do Registro no site da Microsoft. Para evitar esse redirecionamento, você pode exportar o arquivo para um local onde tenha permissões.

/e:Encoding

Opcional. O nome de um formato de codificação do .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, o witadmin tentará detetar a codificação e usará UTF-8 se a deteção falhar.

/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 do prompt de comando.

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.

Painel Backlog com campo Valor Empresarial adicionado

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.

    Mensagem de erro de falha do aplicativo após a atualização do TFS

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.

Personalização

Atualizar ou verificar a definição de tipo de item de trabalho

Atualizar ou verificar a definição de configuração do processo

Adicionar um tipo de item de trabalho à Categoria de Requisitos

(Um tipo de item de trabalho pode pertencer à Categoria de Requisitos ou à Categoria de Tarefa, mas não a ambas.)

Para incluir os seguintes campos:

  • Prioridade de Backlog (Scrum) ou Stack Rank (Agile ou CMMI)

    (deve corresponder ao valor do campo atribuído a type=Order no arquivo de configuração do processo)
  • Esforço (Scrum), Story Points (Agile) ou Tamanho (CMMI)

    (deve corresponder ao valor do campo atribuído no type=Effort arquivo de configuração do processo)
  • Caminho da área ou o valor do campo atribuído no type=Team arquivo de configuração do processo

  • Todos os campos incluídos na AddPanel seção do arquivo de configuração do processo (os campos devem ser definidos dentro da FIELDS seção, mas não precisam ser incluídos na FORM seção.

Para conter os mapeamentos de metaestado necessários:

  • Mapeie o início de cada estado do fluxo de trabalho para type="Proposed"
  • Mapeie cada estado intermediário do fluxo de trabalho que você deseja que apareça no quadro Kanban para type="InProgress"
  • Mapeie o final de cada estado do fluxo de trabalho para type="Complete"
    Você pode ter apenas um Estado mapeado para type="Complete"

    Para conter uma entrada para definir os códigos de cores associados ao WIT. Por exemplo:
    <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

Alterar o fluxo de trabalho de um tipo de item de trabalho na Categoria de Requisitos

N/A

Para conter os mapeamentos de metaestado necessários, conforme descrito acima, para adicionar um tipo de item de trabalho à Categoria de Requisitos.

Adicionar um tipo de item de trabalho à Categoria de Tarefa

Para incluir os seguintes campos:

  • Prioridade de Backlog (Scrum) ou Stack Rank (Agile ou CMMI)
  • Atividade (Scrum ou Agile) ou Disciplina (CMMI)
    (deve corresponder ao valor do campo atribuído no type=Activity arquivo de configuração do processo)
  • Trabalho Restante
    (deve corresponder ao valor do campo atribuído no type=RemainingWork arquivo de configuração do processo)
  • Caminho da área ou o valor do campo atribuído no type=Team arquivo de configuração do processo
  • (Opcional) Trabalho Original e Trabalho Concluído (somente Agile e CMMI)

Para conter os mapeamentos de metaestado necessários:

  • Mapeie o início de cada estado do fluxo de trabalho para type="Proposed"
  • Mapeie cada estado intermediário do fluxo de trabalho que você deseja que apareça no quadro de tarefas para type="InProgress"
  • Mapeie o final de cada estado do fluxo de trabalho para type="Complete"

    Você pode ter apenas um Estado mapeado para type="Complete"

Para conter uma entrada para definir os códigos de cores associados ao WIT. Por exemplo:

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

Alterar o fluxo de trabalho de um tipo de item de trabalho na Categoria de Tarefa

N/A

Para conter os mapeamentos de metaestado necessários, conforme descrito acima, para adicionar um tipo de item de trabalho à Categoria de Tarefa.

Adicionar um tipo de item de trabalho à categoria de bug (somente Agile e CMMI)
Alterar o fluxo de trabalho de um tipo de item de trabalho na categoria Bug (somente Agile e CMMI)

N/A

Para conter os mapeamentos de metaestado necessários:

  • Mapeie o início de cada estado do fluxo de trabalho para type="Proposed"
  • Mapeie cada estado intermediário do fluxo de trabalho que você deseja que apareça para Meu Trabalho type="InProgress"
  • Mapeie o final de cada estado do fluxo de trabalho type="Complete"

Você pode ter apenas um Estado mapeado para type="Complete"

Para saber mais, consulte Status de atualização de bug de suporte usando Meu trabalho.

Remover um tipo de item de trabalho da Categoria de Requisitos ou da Categoria de Tarefa

N/A

Para remover quaisquer mapeamentos de metaestado associados apenas a esse tipo de item de trabalho

Remover um tipo de item de trabalho de um projeto

Para remover o tipo de item de trabalho do arquivo de categorias.

Para remover quaisquer mapeamentos de metaestado associados apenas ao tipo de item de trabalho removido e ao WorkItemColor elemento que define os códigos de cores para o tipo de item de trabalho removido.

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.