Fornecer texto da Ajuda, diretrizes de processo, conteúdo da Web e links para páginas da Web em um formulário de item de trabalho

Artigo
03/12/2013

Quando você personaliza o formulário de item de trabalho, você pode querer fornecer informações ou links para satisfazer que ajuda a equipe para definir os campos no formulário.Se você inserir informações no formulário ou a faz facilmente disponível, os membros da equipe poderão melhor controlar dados úteis.

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

Você altera o formulário de item de trabalho alterando a definição para o tipo de item de trabalho.Você pode usar a ferramenta de linha de comando witadmin , consulte Personalizar e gerenciar tipos de item de trabalho [witadmin], ou o editor do processo.

O editor do processo é um suplemento à ferramenta avançada para o Visual Studio que você pode baixar e instalar.Encontrado no menu ferramentas, o editor do processo fornece uma interface gráfica do usuário para personalizar os objetos usados para itens de trabalho de rastreamento em Team Foundation Server.Você pode usar essa ferramenta para exportar e importar tipos de itens de trabalho e alterar suas definições.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas poderosas do Team Foundation Server.

Você pode fornecer o texto de ajuda em uma de duas maneiras.No primeiro método, você adiciona o elemento de HELPTEXT como um filho do elemento FIELD na seção de FIELDS de definição de tipo.Usando HELPTEXT, você cria 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ê especifica o texto autônomo usando elementos filho de LabelText e de Text .Nesse método, você pode adicionar quanta informação desejar, 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 elemento de Link para mais informações, conforme mostrado no exemplo o 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>

Adicionar rótulos autônomos de texto e do campo de hiperlink

Você pode adicionar texto a um formulário de item de trabalho que não está associado com qualquer campo de item de trabalho usando a opção de LabelControl de atributo de Type do elemento de Control .Texto pode ser planície ou fornecer um hiperlink.Além disso, você pode anexar um hiperlink a um rótulo adicionada ao campo usando a opção de FieldControl .

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

O exemplo a seguir adiciona texto sem formatação “preenche os detalhes de bug aqui.Os campos que não são necessários são recomendados ser preenchidos.” ao 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 de campo de hiperlink

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>

Observação
Para clientes de Team Foundation que não atualizado para a versão mais recente, o texto do atributo de Label aparece.Para clientes de Visual Studio 2012 , a marca de texto é exibida como um hiperlink em que o URL é definido pela marca de Link .

Exemplo: coloque o rótulo com hyperlink para a parte de texto

O exemplo a seguir ilustra como adicionar um hiperlink a parte de um rótulo de campo.Nesse exemplo, o URL é determinado pelos valores que são atribuídos aos elementos de Param baseados no item de trabalho específico.

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

Exemplo: rótulo de texto do hiperlink

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>

Exemplo: combinando o texto e hiperlinks em uma única rótulo

Combinando o texto e hiperlinks em uma única rótulo

Exemplo de dois hiperlinks aplicados ao texto

O exemplo a seguir ilustra como adicionar dois hiperlinks 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 parâmetro- gerado do campo de hiperlink

O exemplo a seguir ilustra como adicionar um hiperlink a um rótulo de campo que é gerada dos valores de parâmetro que são avaliados 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 a opção de WebpageControl de atributo de Type exibir conteúdo da web no formulário de item de trabalho como um controle em vez de vincular a um página da Web separadamente.Esta exibição pode ser útil para fornecer métricas que suporta membro da equipe para exibir o conteúdo de um relatório, um painel, ou outro conteúdo baseado.Você pode fornecer um link para o conteúdo ou inserir o conteúdo bruto HTML em uma marca CDATA.

Exemplo: conteúdo de exibição 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 elementos de WebpageControlOptions e de Link .

<Tab Label="Web">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" Dock="Fill">
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Exemplo: conteúdo de exibição fornecido em uma marca CDATA

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

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

Inserir a orientação de processo

Para fazer a orientação de processo disponível no formulário de item de trabalho, você pode querer adicionar um guia que contém informações sobre o fluxo de trabalho e uso de tipo de item de trabalho.Você pode fazer isso usando a opção de WebpageControl de atributo de Type .Essa opção oferece suporte para inserir texto formatado rico e imagens no formulário usando elementos filho de WebpageControlOptions e de Content .

<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 layout do formulário de item de trabalho

Personalizar dados de acompanhamento de projeto, formulários, fluxo de trabalho e outros objetos

Compartilhar via