Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Azure DevOps Server | Azure DevOps Server 2022
Quando personaliza o formulário do seu item de trabalho, pode querer fornecer informações ou links para conteúdos que ajudem a sua equipa a definir os campos do formulário. Se incorporar informação no formulário ou a disponibilizar facilmente, os membros da equipa conseguem acompanhar melhor dados úteis.
Ao utilizar os controlos do formulário descritos neste tópico, pode adicionar texto tipo tooltip para campos individuais, texto autónomo ou hiperligações para páginas web, ou incorporar conteúdo HTML ou conteúdo web no formulário.
Para modificar um WIT existente, modifica o ficheiro de definição XML do WIT e depois importa-o para o teu projeto com base no modelo de processo que utilizas.
Tip
Com o witadmin, você pode importar e exportar arquivos de definição. Outras ferramentas que você pode usar incluem o Editor de processos (requer que você tenha instalado uma versão do Visual Studio). Instale o editor de modelo de processo do Visual Studio Marketplace.
Fornecer texto de ajuda ou texto de dica de ferramenta
Pode fornecer texto de ajuda de duas formas. No primeiro método, adiciona o HELPTEXT elemento como filho ao FIELD elemento na FIELDS secção da definição do tipo. Usando HELPTEXT, você cria a dica de ferramenta para o campo. Estás 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, especifique o texto independente usando os elementos filhos LabelText e Text. Neste método, você pode adicionar quantas informações quiser, 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 Link 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>
Adicionar texto autónomo e etiquetas de campo de hiperligação
Adicione texto a um formulário de item de trabalho que não esteja associado a nenhum campo de item de trabalho usando a Type opção de atributo LabelControl do Control elemento. O texto pode ser simples ou fornecer um hiperlink. Também pode anexar um hiperlink a um rótulo de campo adicionado usando a FieldControl opção.
Exemplo: rótulo de texto sem formatação
O exemplo a seguir adiciona o texto simples "Preencha os detalhes do bug aqui. Os campos que não são obrigatórios são recomendados para serem preenchidos." no campo do 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 seguinte mostra 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 Team Foundation que não atualizam para a versão mais recente, o Label texto do atributo aparece. Para clientes do Visual Studio 2012, a marca Text é exibida como um hiperlink no qual a URL é definida pela marca Link.
Exemplo: rótulo de campo com hiperlink para parte do texto
O exemplo seguinte mostra como adicionar um hiperlink a parte de um rótulo de campo. Neste exemplo, os valores que atribui aos Param elementos determinam a URL com base 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 de hiperlink
Rótulo de texto do hiperlink
O exemplo seguinte mostra como adicionar um hiperlink ao texto apresentado numa forma 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: combinação de texto e hiperligações numa única etiqueta
Combinando texto e hiperlinks em um único rótulo
O exemplo seguinte mostra como adicionar dois hiperlinks para partes de uma etiqueta num 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="http://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 de campo de hiperlink gerado por parâmetros
O exemplo seguinte mostra como adicionar um hyperlink a um rótulo de campo gerado a partir de valores de parâmetros avaliados para o item de trabalho aberto.
<Control Type="FieldControl" FieldName="System.State" Label="&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>
Exibição de conteúdo da Web
Utilize a opção do atributo Type para apresentar conteúdo web no formulário do item de trabalho como controle, em vez de ligar para uma página web separada. Essa exibição pode ser útil para fornecer métricas que dão suporte aos membros da equipe na visualização do conteúdo de um relatório, painel ou outro 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 seguinte mostra como pode incorporar o conteúdo de uma página web fornecendo a URL da página usando os WebpageControlOptions elementos e Link .
<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>
Exemplo: exibir conteúdo fornecido em uma tag CDATA
O exemplo a seguir mostra como pode adicionar conteúdo HTML a um formulário de item de trabalho contido numa etiqueta CDATA.
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Place HTML Formatted Content Here ]]>
</Content>
</WebpageControlOptions>
</Control>