Share via


Fornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho

Quando você personaliza o formulário de item de trabalho, convém fornecer informações ou links para conteúdo que ajude sua equipe define os campos no formulário. Se você insere informações no formulário ou disponibilizá-lo facilmente, os integrantes da equipe poderão melhor controlar 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ônomas ou hiperlinks para páginas da Web ou incorporar conteúdo HTML ou conteúdo da Web no formulário.

Você pode modificar o formulário de item de trabalho, modificando a definição para o tipo de item de trabalho. Você pode usar o witadmin ferramenta de linha de comando, consulte Importar, exportar e gerenciar tipos de item de trabalho [witadmin], ou o Editor de processo.

O Editor de processo é um potência suplemento Ferramentas para o Visual Studio que você pode baixar e instalar. Editor de processo localizada no menu Ferramentas, fornece uma interface gráfica do usuário para personalizar os objetos usados para acompanhar itens de trabalho no Team Foundation Server. Você pode usar essa ferramenta para importar e exportar tipos de item de trabalho e modificar suas definições. Para saber mais, veja a seguinte página no site da Microsoft: Team Foundation Server Power Tools.

Fornecer texto da Ajuda ou texto de dica de ferramenta

Você pode fornecer o texto de ajuda de duas maneiras. O primeiro método, você adicionará o HELPTEXT elemento como um filho para o FIELD elemento o FIELDS seção da definição de tipo. Usando HELPTEXT, criar a dica de ferramenta para o campo. Você está limitado a 255 caracteres com esse 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ônomas usando o LabelText e Text elementos filho. Nesse método, você pode adicionar quantas informações desejar, e o texto está sempre presente no formulário. Não é necessária nenhuma ação do usuário. 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" UrlRoot=http://ACE.ImpactStatement.aspx />
      </Text>
   </LabelText>
</Control>

Você pode adicionar texto a um formulário de item de trabalho que não esteja associado a qualquer campo de item de trabalho usando o Type atributo LabelControl opção do Control elemento. O texto pode ser simples ou fornecer um hiperlink. Além disso, você pode anexar um hiperlink para um rótulo 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 erro aqui. 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." />

O exemplo a seguir ilustra como adicionar um hiperlink a 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>

Dica

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

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 ao Param elementos com base em específicos do item de trabalho.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">
            <Param Index="0" vValue"System.WorkItemType"/>         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Rótulo de texto do hiperlink

Exemplo de aplicar um rótulo autônomo hiperlink

O exemplo a seguir ilustra como adicionar um hiperlink ao 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>

Combinação de texto e hiperlinks em um único rótulo

Exemplo de dois hiperlinks aplicados ao texto

O exemplo a seguir ilustra como adicionar dois hiperlinks a 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>

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

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" 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 separada. Essa exibição pode ser útil para fornecer métricas que dão suporte a membros da equipe na exibição do conteúdo de um relatório, painel ou outros tipos de conteúdo baseado em HTML. Você pode fornecer um link para o conteúdo ou incorporar o conteúdo HTML bruto em uma tag CDATA.

Exemplo: exibir conteúdo fornecido por um URI

O exemplo a seguir mostra como você pode inserir 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" >
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Exemplo: exibir 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 uma CDATA marca.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
      <![CDATA[Place HTML Formatted Content Here ]]
   </Content>
   </WebpageControlOptions >
</Control>

Incorporar as diretrizes de processo

Para disponibilizar as diretrizes de processo no formulário de item de trabalho, convém 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. Essa opção oferece suporte para inserção rich texto formatado e imagens no formulário usando o WebpageControlOptions e Content elementos filho.

<FORM>
. . .
<TabGroup>
. . . 
   <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>
. . .
</TabGroup>
. . .
</FORM>

Consulte também

Conceitos

Criar o formulário de item de trabalho

Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe