Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail
Quand vous personnalisez votre formulaire d'élément de travail, vous pouvez fournir des informations ou des liens vers du contenu pour aider votre équipe à définir les champs du formulaire. Si vous incorporez des informations dans le formulaire ou que vous facilitez l'accès à celles-ci, les membres de l'équipe seront plus à même de faire le suivi de données utiles.
À l'aide des contrôles de formulaire décrits dans cette rubrique, vous pouvez soit ajouter du texte info-bulle à des champs individuels, à du texte autonome ou à des liens hypertexte vers des pages web, soit incorporer du contenu HTML ou web au formulaire.
Pour modifier un formulaire d'élément de travail, vous devez modifier la définition du type d'élément de travail. Pour cela, vous pouvez utiliser l'outil en ligne de commande witadmin (consultez Importer, exporter et gérer des types d'éléments de travail [witadmin]) ou Process Editor.
Process Editor est un complément Power Tool pour Visual Studio que vous pouvez télécharger et installer. Situé sous le menu Outils, Process Editor offre une interface utilisateur graphique dans laquelle vous pouvez personnaliser des objets utilisés pour suivre des éléments de travail dans Team Foundation Server. Cet outil vous permet non seulement d'importer et d'exporter des types d'éléments de travail, mais aussi de modifier leur définition. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Team Foundation Server Power Tools.
Ajouter du texte d'aide ou du texte info-bulle
Deux méthodes s'offrent à vous pour ajouter du texte d'aide. Dans la première méthode, vous ajoutez l'élément HELPTEXT en tant qu'enfant à l'élément FIELD dans la section FIELDS de la définition de type. L'élément HELPTEXT vous permet de créer l'info-bulle pour le champ. Cette méthode limite le texte à 255 caractères.
<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>
Dans la deuxième méthode, vous spécifiez le texte autonome à l'aide des éléments enfants LabelText et Text. Dans cette méthode, vous pouvez ajouter autant d'informations que vous le souhaitez, et le texte est toujours présent sur le formulaire. Aucune intervention de l'utilisateur n'est requise. Vous pouvez également ajouter un lien facultatif vers d'autres informations à l'aide de l'élément Link, comme le montre l'exemple suivant.
<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>
Ajouter du texte autonome et des étiquettes de champ de lien hypertexte
Pour ajouter du texte à un formulaire d'élément de travail qui n'est associé à aucun champ d'élément de travail, utilisez l'option LabelControl de l'attribut Type de l'élément Control. Le texte peut être brut ou contenir un lien hypertexte. Vous pouvez aussi attacher un lien hypertexte à une étiquette de champ ajoutée à l'aide de l'option FieldControl.
Exemple : étiquette de texte brut
L'exemple suivant ajoute le texte brut « Fill in the details of the bug here. Fields that are not required are recommended to be filled in. » au champ d'élément de travail.
<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />
Exemple : étiquette de champ de lien hypertexte
L'exemple suivant montre comment ajouter un lien hypertexte à une étiquette de champ.
<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
<LabelText>
<Text>
<Link UrlRoot="http://www.live.com/" />
Title 2
</Text>
</LabelText>
</Control>
Notes
Pour les clients Team Foundation qui n'ont pas effectué la mise à niveau vers la dernière version, le texte de l'attribut Label s'affiche.Pour les clients Visual Studio 2012, la balise Text s'affiche sous forme d'un lien hypertexte dans lequel l'URL est définie par la balise Link.
Exemple : étiquette de champ avec un lien hypertexte pour une partie du texte
L'exemple suivant montre comment ajouter un lien hypertexte à une partie d'une étiquette de champ. Dans cet exemple, l'URL est déterminée par les valeurs qui sont assignées aux éléments Param en fonction de l'élément de travail spécifique.
<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>
Exemple : étiquette de texte de lien hypertexte
Étiquette de texte de lien hypertexte
.png "Exemple d'un lien hypertexte appliqué à une étiquette autonome")
L'exemple suivant montre comment ajouter un lien hypertexte au texte affiché dans un formulaire d'élément de travail.
<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>
Exemple : combinaison de texte et de liens hypertexte dans une étiquette unique
Combinaison de texte et de liens hypertexte dans une étiquette unique
.png "Exemple de deux liens hypertexte appliqués au texte")
L'exemple suivant montre comment ajouter deux liens hypertexte à des parties d'une étiquette sur un formulaire d'élément de travail.
<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>
Exemple : étiquette de champ de lien hypertexte générée par un paramètre
L'exemple suivant montre comment ajouter un lien hypertexte à une étiquette de champ générée à partir de valeurs de paramètre qui sont évaluées pour l'élément de travail ouvert.
<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>
Affichage du contenu web
Vous pouvez utiliser l'option WebpageControl de l'attribut Type pour afficher le contenu web dans le formulaire d'élément de travail en tant que contrôle au lieu de créer un lien vers une page web distincte. Les membres de l'équipe disposent ainsi de métriques qui peuvent se révéler utiles lors de l'examen d'un rapport, d'un tableau de bord ou de tout autre contenu HTML. Vous pouvez fournir un lien vers le contenu ou incorporer le contenu HTML brut dans une balise CDATA.
Exemple : afficher du contenu fourni par un URI
L'exemple suivant montre comment vous pouvez incorporer le contenu d'une page web en fournissant l'URL de la page à l'aide des éléments WebpageControlOptions et Link.
<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>
Exemple : afficher du contenu fourni dans une balise CDATA
L'exemple suivant montre comment ajouter du contenu HTML à un formulaire d'élément de travail contenu dans une balise CDATA.
<Control Type="WebpageControl">
<WebpageControlOptions>
<Content>
<![CDATA[Place HTML Formatted Content Here ]]
</Content>
</WebpageControlOptions >
</Control>
Incorporer le guide de processus
Pour que le guide de processus soit accessible sur le formulaire d'élément de travail, vous pouvez ajouter un onglet qui contient des informations sur le flux de travail et l'utilisation du type d'élément de travail. Pour cela, vous pouvez utiliser l'option WebpageControl de l'attribut Type. Cette option prend en charge l'incorporation de texte enrichi et d'images dans le formulaire à l'aide des éléments enfants WebpageControlOptions et 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>
Voir aussi
Concepts
Concevoir le formulaire d'élément de travail
Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe