Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho

Ao personalizar o seu formulário de item de trabalho, você poderá fornecer informações ou links para conteúdo que ajuda sua equipe define os campos no formulário. Se você incorpora as informações no formulário ou disponibilizá-lo facilmente, os membros da equipe poderão melhor rastrear dados úteis."

Usando os controles de formulário são descritos neste tópico, você pode adicionar texto de dica de ferramenta para campos individuais, texto autônomo ou hiperlinks para páginas da Web ou incorporar o conteúdo HTML ou conteúdo da Web no formulário.

Neste tópico

• Fornecendo o texto de Ajuda ou texto de dica de ferramenta

• Adicionando texto independente e rótulos de campo de hiperlink

• Exibindo conteúdo da Web

• A incorporação de diretrizes de processo

Fornecendo o texto de Ajuda ou texto de dica de ferramenta

Você pode fornecer o texto de ajuda de duas maneiras. O primeiro método, você adiciona o HELPTEXT elemento como um filho para o FIELD elemento a FIELDS seção da definição de tipo. Usando HELPTEXT, você poderá criar a dica de ferramenta para o campo. Você está limitado a 255 caracteres com este método.

<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>

No segundo método, você deve especificar texto autônomo usando o LABELTEXT e TEXT elementos filho. Nesse método, você pode adicionar as informações desejadas, e o texto está sempre presente no formulário. Nenhuma ação do usuário é necessária. Você também pode adicionar um link opcional usando o LINK elemento para obter mais informações, conforme mostrado no exemplo a seguir.

<CONTROL FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left"> 
   <LABELTEXT>
      <TEXT> Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:
         <LINK> OpenInNewWindow="true" URL="http://ACE.ImpactStatement.aspx"
         </LINK>
      </TEXT>
   </LABELTEXT>
</CONTROL>

Adicionando texto independente e rótulos de campo de hiperlink

Você pode adicionar texto a um formulário de item de trabalho que não está associado a qualquer item de campo de trabalho usando o Type atributo LabelControl a opção do CONTROL elemento. O texto pode ser simples ou fornecer um hyperlink. Além disso, você pode anexar um hiperlink para um rótulo de campo adicionado usando o FieldControl opção.

Exemplo: Rótulo de texto sem formatação

O exemplo a seguir adiciona o texto sem formatação "preencha os detalhes do bug aqui. Os campos que não são necessários são recomendados para ser preenchido." para o campo de item de trabalho.

<CONTROL Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

Exemplo: Rótulo do campo de hiperlink

O exemplo a seguir ilustra como adicionar um hiperlink para um rótulo de campo.

<CONTROL Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
   <LABELTEXT>
      <TEXT>
         <LINK UrlRoot="http://www.live.com/" />
            Title 2
      </TEXT>
   </LABELTEXT>
</CONTROL>

Observação
Para Team Foundation os clientes que não fizeram a atualização para a versão mais recente, o Label o texto do atributo é exibido. Para Visual Studio 2010 clientes, o texto de marca é exibida como um hiperlink em que a URL é definida pela Link marca.

Exemplo: Rótulo do campo com um hiperlink para a parte do texto

O exemplo a seguir ilustra como adicionar um hiperlink à parte de um rótulo de campo. Neste exemplo, a URL é determinada pelos valores que são atribuídos para o PARAM elementos com base no item de trabalho específico.

<CONTROL Type="FieldControl" FieldName="System.IterationPath">
   <LABELTEXT LabelPosition="Left">
      <TEXT>
         <LINK URL="http://{0}/sites/{1}/render.aspx?wit=bug&amp;topic=Iteration">
            <PARAM value="@Server"/>
            <PARAM value="System.Project"/>
         </LINK>
            Iteration Path
      </TEXT>
      <TEXT> (must be 3 levels deep)</Text>
   </LABELTEXT>
</CONTROL>

Exemplo: Rótulo de texto do hiperlink

Rótulo de texto do hiperlink

O exemplo a seguir ilustra como adicionar um hiperlink para o texto exibido em um formulário de item de trabalho.

<GROUP>
   <COLUMN PercentWidth="100">
      <!-- Standalone label control 2 -->
      <CONTROL Type="LabelControl" Label="How do I use this work item?">
         <LINK UrlRoot="http://www.live.com"></Link>
      </CONTROL>
   </COLUMN >
</ GROUP >

Exemplo: A combinação de texto e hiperlinks em uma única etiqueta

A combinação de texto e hiperlinks em uma única etiqueta

O exemplo a seguir ilustra como adicionar dois hiperlinks para as partes de um rótulo em um formulário de item de trabalho.

<GROUP>
   <COLUMN PercentWidth="100">
   <!-- Standalone label control 3 -->
      <CONTROL Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
         <LABELTEXT>
            <TEXT>Click here for </TEXT>
            <TEXT>
               <LINK UrlRoot="https://www.msn.com"></LINK>
               work item guidance</TEXT>
            <TEXT> or here for </TEXT>
            <TEXT>
               <LINK UrlRoot="http://www.msdn.com"></LINK>
               process guidance
            </TEXT>
         </LABELTEXT>
      </CONTROL>
   </COLUMN>
</GROUP>

Exemplo: Rótulo do campo de hiperlink gerado de parâmetro

O exemplo a seguir ilustra como adicionar um hiperlink para um rótulo de campo é gerado a partir de valores de parâmetro são avaliadas para o item de trabalho aberta.

<CONTROL Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <LINK OpenInNewWindow="true" URL="http://{0}/sites/{1}/render.aspx?wit=bug&amp;state={2}">
      <PARAM value="@Server"/>
      <PARAM value="System.Project"/>
      <PARAM value="System.State" type ="original"/>
   </LINK>
</CONTROL>

Exibindo conteúdo da Web

Você pode usar o Type atributo WebpageControl opção para exibir o conteúdo da Web no formulário de item de trabalho como um controle em vez de vincular a uma página da Web separado. Essa tela pode ser útil para fornecer métricas que dão suporte a membros da equipe em ver o conteúdo de um relatório, o painel de controle ou outro conteúdo baseado em HTML. Você pode fornecer um link para o conteúdo ou incorporar o conteúdo bruto de HTML em uma tag CDATA.

Exemplo: Exibir o conteúdo fornecido por um URI.

O exemplo a seguir mostra como você pode incorporar o conteúdo de uma página da Web, fornecendo o URL para a página usando o WEBPAGECONTROLOPTIONS e LINK elementos.

<Tab Label="Web">
   <GROUP>
      <COLUMN PercentWidth="100">
         <CONTROL Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" Dock="Fill">
            <WEBPAGECONTROLOPTIONS AllowScript="false">
               <LINK UrlRoot="http://www.msdn.com" />
            </WEBPAGECONTROLOPTIONS >
         </CONTROL>
      </COLUMN>
   </GROUP>
</TAB>

Exemplo: Exibir o conteúdo fornecido em uma Tag CDATA

O exemplo a seguir mostra como você pode adicionar conteúdo HTML a um formulário de item de trabalho que está contido em um CDATA marca.

<CONTROL Type="WebpageControl">
   <WEBPAGECONTROLOPTIONS>
      <CONTENT>
      <![CDATA[Place HTML Formatted Content Here ]]
   </CONTENT>
   </WEBPAGECONTROLOPTIONS>
</CONTROL>

A incorporação de diretrizes de processo

Para disponibilizar a orientação do processo no formulário de item de trabalho, você talvez queira adicionar uma guia que contém informações sobre o fluxo de trabalho e o uso do tipo de item de trabalho. Você pode fazer isso usando o Type atributo WebpageControl opção. Esta opção fornece suporte para incorporação rich formatado o texto e imagens no formulário usando o WEBPAGECONTROLOPTIONS e CONTENT elementos filho.

<FORM>
. . .
<TABGROUPS>
. . . 
   <TAB Label="Process Guidance">
      <Group>
         <COLUMN PercentWidth="100">
            <CONTROL Type="WebpageControl">
            <WEBPAGECONTROLOPTIONS>
            <CONTENT>
               <![CDATA[Place HTML Formatted Process Guidance Content Here ]]>
            </CONTENT>
            </WEBPAGECONTROLOPTIONS>
            </CONTROL>
         </COLUMN>
      </GROUP>
   </TAB>
. . .
</TABGROUPS>
. . .
</FORM>

Consulte também

Referência

Referência de elemento do controle XML

Elemento FIELD (fluxo de trabalho)

Conceitos

Especificando os controles de formulário de Item de trabalho

Criar o Layout do formulário de Item de trabalho

Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto

Outros recursos

Controlar a exibição de campos de Item de trabalho