Personalizar o formulário da Web de acompanhamento de trabalho

Azure DevOps Server 2022 – Azure DevOps Server 2019

Este artigo se aplica às personalizações que você pode fazer ao usar o modelo de processo XML hospedado ou o modelo de processo XML local para um Servidor de DevOps do Azure local. Para o modelo de processo de herança, consulte Personalizar um processo. Para obter uma visão geral dos modelos de processo, consulte Personalizar sua experiência de acompanhamento de trabalho.

Importar/exportar arquivos de definição XML

Use essa sequência ao usar o modelo de processo XML local e gerenciar sua personalização de controle de trabalho por meio da importação de arquivos de definição XML individuais.

Importar/exportar arquivos zip do processo

Use essa sequência ao usar o modelo de processo XML hospedado e gerencie sua personalização de controle de trabalho importando um modelo de processo ou processo.

Seção FORMULÁRIO

A principal diferença é que agora há duas seções de layout principais dentro do nó FORM . A primeira seção, contida no elemento Layout, define o layout do formulário quando exibido por meio de um cliente, como o Visual Studio. A segunda seção, contida no elemento WebLayout , define o layout do formulário quando exibido por meio de um navegador da Web.

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

Consulte os tópicos a seguir para fazer as personalizações indicadas:

• Para personalizar o formulário para o portal da Web (nó WebLayout ), consulte WebLayout e elementos XML de controle
• Para adicionar um controle de links com escopo ao formulário do portal da Web (LinksControlOptions), consulte Elementos XML LinksControlOptions
• Para personalizar o formulário do cliente (nó Layout ), consulte Elementos XML de layout.

Importar e exportar arquivos de definição (processo XML local)

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

2. Abra uma janela do Prompt de Comando de acordo com as instruções fornecidas em witAdmin: Personalizar e gerenciar objetos para acompanhar o trabalho.

   Por exemplo:

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

3. Exporte o arquivo de definição WIT onde você deseja modificar ou adicionar um campo. Especifique o nome do WIT e um nome para o arquivo.

   witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
   

   Um exemplo de um CollectionURL para uma organização é https://dev.azure.com/OrganizationName.

4. Edite o arquivo . Para obter detalhes, consulte Elementos XML WebLayout.

5. Importe o arquivo de definição WIT.

   witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"  
   

6. Abra o portal da Web para exibir as alterações. Se o cliente já estiver aberto, atualize a página.

   As atualizações mais recentes são baixadas do servidor, incluindo as alterações que você acabou de importar. Aguarde alguns segundos até que a atualização seja concluída.

   Para obter mais informações sobre como usar o witadmin, consulte Importar, exportar e gerenciar tipos de item de trabalho.

Dica

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

Layout e redimensionamento

O formulário da Web é redimensionado dependendo da largura disponível e do número de seções definidas. Na largura máxima, na maioria dos navegadores da Web, cada seção dentro de uma página será exibida dentro de sua própria coluna. À medida que a largura da tela diminui, cada seção é redimensionada proporcionalmente da seguinte maneira:

• Para quatro seções: 40%, 20%, 20% e 20%
• Para três seções: 50%, 25% e 25%
• Para duas Seções: 66% e 33%
• Para uma seção: 100%.

Quando a largura de exibição não acomoda a exibição colunar de cada seção, as seções aparecem empilhadas em uma coluna.

Listas globais

As listas globais são gerenciadas de forma diferente no XML hospedado do que no Servidor de DevOps do Azure. O witadmin comando e um arquivo de lista global separado não são suportados. Em XML hospedado, você anexa listas globais a um tipo de item de trabalho existente, conforme ilustrado no trecho de código a seguir.

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

Por padrão, as listas globais serão anexadas ao tipo de item de trabalho Etapas Compartilhadas.

Importar avisos e erros

Você receberá um aviso ao importar uma definição WIT modificada se adicionar um elemento Control para um campo obrigatório somente no nó WebLayout ou Layout , mas não no outro.

Você receberá um erro se habilitar o novo formulário e, em seguida, modificar uma definição WIT na qual você exclui o nó WebLayout .

Artigos relacionados

• Adicionar e modificar um WIT