Editar uma definição de WIT para adicionar conteúdo da Web a um formulário de item de trabalho

Artigo
09/13/2015

Você pode adicionar conteúdo da Web ou conteúdo HTML a um formulário de item de trabalho, exportando o arquivo XML de definição de tipo e adicionando um WebpageControl na seção FORM. Depois de modificar e importar o arquivo XML, será possível verificar a exibição de conteúdo da Web no tipo de item de trabalho atualizado.

O conteúdo da Web que você exibe pode ser especificado de uma das seguintes maneiras:

URL de uma página da Web
Um caminho de URL determinado dinamicamente no tempo de execução com base em um ou mais valores de campos definidos para o item de trabalho
Conteúdo HTML

Para obter informações sobre a estrutura de sintaxe dos elementos usados para adicionar conteúdo da Web para um tipo de item de trabalho (WIT), consulte Referência de elementos XML WebpageControlOptions e Referência de elementos XML Link e Param.

Requisitos

Você deve ser um membro do administradores do projeto no projeto de equipe. Consulte Adicionar usuários a projetos da equipe.

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

Execute uma das seguintes etapas com base no escopo da personalização que você deseja executar:

Se você for modificar um tipo de item de trabalho para um único projeto:
1. Execute witadmin exportwitd para exportar o arquivo XML do 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. No Visual Studio, escolha Arquivo, Abrir, Arquivo.
3. Em Examinar, mova para o local onde você exportou o arquivo.
Se você for modificar um tipo de item de trabalho para personalizar um modelo de projeto:
1. Encontre o local onde você baixou o modelo de processo.
2. Selecione o arquivo XML do tipo de item de trabalho que você deseja atualizar e escolha Abrir. Quando for questionado sobre as terminações de linha, clique em Não.

Adicionar conteúdo da Web à seção FORM do arquivo de definição

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

Adicione um novo elemento <Tab> que conterá o conteúdo da Web ou HTML que você deseja exibir no formulário de item de trabalho. Copie o seguinte código na seção <TabGroup> do arquivo com base em como você está definindo o conteúdo da Web.

Para especificar a URL de uma página da Web:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Substitua rótulo da guia e URL da página da Web com as informações que você deseja que apareça no formulário de item de trabalho.

Para especificar uma URL dinâmica a ser determinada no tempo de execução:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Substitua rótulo da guia, URL da página da Web, o caminho de URL com parâmetros, e Param valor 1, 2 e 3 com as informações que você deseja que apareça no formulário de item de trabalho.

Para especificar o conteúdo HTML:
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Substitua rótulo da guia e conteúdo HTML com as informações que você deseja que apareça no formulário de item de trabalho.

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.

Salve as alterações no arquivo XML.
Use witadmin importwitd para importar o novo tipo de item de trabalho para um único projeto. Para adicionar o tipo de item de trabalho para seu modelo de processo, consulte Adicionar definições de tipo para itens de trabalho a um modelo de processo.

Verificar se a página da Web ou o conteúdo HTML aparece no formulário

Em Team Explorer, abrir itens de trabalho para o projeto de equipe que contém a definição de WIT modificada e escolha atualização.

As atualizações mais recentes são baixadas do servidor, incluindo as alterações que você acabou de importar. Aguarde alguns segundos até que o nó Itens de Trabalho seja atualizado. Os nós que ainda estão carregando exibem a palavra processando.
Crie um item de trabalho usando o WIT modificado.

Verifique se a página da Web ou o conteúdo HTML aparece no formulário como esperado.
Escolha Fechar para fechar o novo item de trabalho.