Compartilhar via


Alterar o layout do formulário de item de trabalho

Você pode alterar o layout do formulário de item de trabalho exportando o arquivo XML e modificando o conteúdo da seção FORM. Depois de modificar e importar o arquivo XML, será possível verificar as alterações feitas no tipo de item de trabalho atualizado. Os tipos de alterações de layout que você pode fazer incluem, sem limitação, o seguinte:

  • Alterar o rótulo ou o posicionamento de um campo no formulário

  • Mover grupos de campos de uma guia para outra

  • Adicionar novas guias ou colunas

Para obter uma visão geral dos controles que você pode colocar em um formulário de item de trabalho, consulte Especificar controles de formulários de itens de trabalho. Para obter uma visão geral dos elementos estruturais de nível superior da seção FORM, consulte: Criar o formulário de item de trabalho.

Requisitos

Para executar este procedimento, você deve ser membro do grupo Administradores do Team Foundation ou do grupo Administradores do Projeto no projeto. Para obter mais informações, consulte Referência de permissões para o Team Foundation Server.

Exportar e abrir o arquivo de definição do WIT

  • Execute uma das seguintes etapas com base no escopo da personalização que você está fazendo:

    Se você for modificar um tipo de item de trabalho para um único projeto:

    1. Execute witadmin exportwitd para exportar o arquivo XML para o tipo de item de trabalho que você deseja modificar. Para obter mais informações, consulte Importar, exportar e gerenciar tipos de item de trabalho [witadmin].

    2. Abrir o arquivo no Visual Studio.

    Se você for modificar um WIT para personalizar um modelo de projeto:

    1. Mova para o local onde você baixou o modelo de processo.

    2. Abra o arquivo XML do WIT.

Alterar o layout da seção FORM

  1. Localize a seção <TabGroup> do arquivo XML. Observe que há elementos <Tab> para itens, como Links e Anexos de Arquivo, em que cada elemento <Tab> contém um elemento <Control> que renderiza o respectivo controle.

    <Tab Label="Links">
      <Control Type="LinksControl" />
    </Tab>
    <Tab Label="File Attachments">
      <Control Type="AttachmentsControl" />
    </Tab>
    
  2. Mescle os dois elementos <Tab> em um único elemento <Tab> de links e anexos que contenha ambos os controles substituindo o XML mostrado na etapa anterior pelo novo XML mostrado no seguinte exemplo:

    <Tab Label="Links and Attachments">
      <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
      <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
    </Tab>
    
  3. Localize a seção <FORM>, a definição de <Layout> que descreve o grupo que você deseja alterar, como o grupo Classification.

    <Group Label="Classification">
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>
    

    Dica

    Para obter melhores resultados, cada controle ou grupo deve aparecer em uma coluna, mesmo se a coluna ocupar a largura total do formulário.Por sua vez, cada coluna deve ser exibida em um grupo, mesmo se o grupo não tiver rótulo ou limite visível.

  4. Selecione e copie as seguintes linhas para a área de transferência para uso posterior.

    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" /> 
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
    
  5. Exclua as linhas que começam com <Group Label="Classification"> e terminam com <Group> no seguinte XML, para remover o grupo Classification de sua posição atual no formulário.

    <Layout>
      <Group>
        <Column PercentWidth="70">
          <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
        </Column>
        <Column PercentWidth="30">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
        </Column>
      </Group>
      <Group Label="Classification"> 
        <Column PercentWidth="100"> 
          <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" /> 
          <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" /> 
        </Column> 
      </Group>
    
  6. Na seção <TabGroup>, localize as seguintes linhas que definem o guia Detalhes:

    <Tab Label="Details">
      <Group>
        <Column PercentWidth="50">
          <Group Label="General">
            <Column PercentWidth="100">
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&amp;ontext:" LabelPosition="Left" ReadOnly="True" />
            </Column>
          </Group>
        </Column>
        <Column PercentWidth="50">
          <Group Label="Schedule">
            <Column PercentWidth="100">
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&amp;e:" LabelPosition="Left" ReadOnly="True" />
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&amp;Finish Date:" LabelPosition="Left" ReadOnly="True" />
            </Column>
          </Group>
        </Column>
      </Group>
    </Tab>
    
  7. Para mover esses controles para a guia de Detalhes , cole o conteúdo da área de transferência abaixo do elemento de <Tab Label="Details"> .

    <Tab Label="Details">
      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" /> 
      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      <Group>
        <Column PercentWidth="50">
          <Group Label="General">
            <Column PercentWidth="100">
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
    ...
    
  8. Faça as seguintes alterações para criar um agrupamento em torno dos campos e movidos para dividir os campos em duas colunas:

    <Tab Label="Details">
      <Group Label="Classification"> 
        <Column PercentWidth="50"> 
          <Group> 
            <Column PercentWidth="100"> 
              <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
              <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
            </Column> 
          </Group> 
        </Column> 
        <Column PercentWidth="50"> 
          <Group> 
            <Column PercentWidth="100"> 
              <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />
            </Column> 
          </Group> 
        </Column> 
      </Group>
      <Group>
        <Column PercentWidth="50">
          <Group Label="General">
            <Column PercentWidth="100">
              <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
    ...
    
  9. Salve as alterações.

  10. Para importar o novo tipo de item de trabalho para um único projeto, consulte Importar, exportar e gerenciar tipos de item de trabalho [witadmin]. Para adicionar o tipo de item de trabalho ao modelo de processo, consulte Adicionar definições de tipo para itens de trabalho a um modelo de processo.

Verifique a página da Web ou conteúdo HTML aparece no formulário do item de trabalho

  1. No Team Explorer, escolha Atualizar para baixar as atualizações mais recentes do servidor.

    Essas atualizações incluem as alterações que foram importados apenas. Aguarde alguns segundos até que o nó de Itens de Trabalho seja carregado. Os nós que ainda estão carregando exibem a palavra processando.

  2. Criar um item de trabalho novo usando o tipo de item de trabalho que você modificou.

    Observe que o grupo de classificação não está mais no formato principal. Na guia de Links e Anexos escolha a guia de Detalhes para ver os resultados das alterações que fez.

Consulte também

Referência

Importar, exportar e gerenciar tipos de item de trabalho [witadmin]

Conceitos

Criar o formulário de item de trabalho

Especificar controles de formulários de itens de trabalho