Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail

Lorsque vous personnalisez votre formulaire d'élément de travail, vous pouvez fournir des informations ou des liens vers le contenu qui aide votre équipe à définir les champs du formulaire. Si vous incorporez les informations dans le formulaire ou en facilitez l'accès, les membres de l'équipe pourront mieux suivre les données utiles.

En utilisant les contrôles de formulaire décrits dans cette rubrique, vous pouvez ajouter du texte d'info-bulle pour les champs individuels, du texte autonome ou des liens hypertexte aux pages Web ou encore incorporer du contenu HTML ou contenu Web au formulaire.

Dans cette rubrique

• Ajout de texte d'aide ou de texte d'info-bulle

• Ajout d'étiquettes de texte autonome et de champ Lien hypertexte

• Affichage du contenu Web

• Incorporation du guide de processus

Ajout de texte d'aide ou de texte d'info-bulle

Vous pouvez fournir du texte d'aide de deux façons. 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. En utilisant HELPTEXT, vous créez l'info-bulle pour le champ. Vous êtes limité à 255 caractères avec cette méthode.

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

Dans la seconde 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 nécessaire, 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 en utilisant l'élément Link vers plus d'informations, comme dans 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>

Ajout d'étiquettes de texte autonome et de champ Lien hypertexte

Vous pouvez ajouter du texte à un formulaire d'élément de travail qui n'est associé à aucun champ d'élément de travail en utilisant l'option LabelControl de l'attribut Type de l'élément Control. Le texte peut être brut ou représenter un lien hypertexte. En outre, vous pouvez 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 Lien hypertexte

L'exemple suivant illustre l'ajout d'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 été mis à niveau vers la dernière version, le texte de l'attribut Label s'affiche. Pour les clients Visual Studio 2010, la balise Text s'affiche en tant que lien hypertexte dans lequel l'URL est définie par la balise Link.

Exemple : étiquette de champ avec un lien hypertexte dans une partie du texte

L'exemple suivant illustre l'ajout d'un lien hypertexte à une partie d'étiquette de champ. Dans cet exemple, l'URL est déterminée par les valeurs assignées aux éléments Param selon l'élément de travail spécifique.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlPath="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>

Exemple : étiquette de texte de lien hypertexte

Étiquette de texte de lien hypertexte

L'exemple suivant illustre l'ajout d'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 en une étiquette unique

Combinaison de texte et de liens hypertexte en une étiquette unique

L'exemple suivant illustre l'ajout de deux liens hypertexte à des parties d'une étiquette dans 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 Lien hypertexte générée par un paramètre

L'exemple suivant illustre l'ajout d'un lien hypertexte à une étiquette de champ générée à partir de valeurs de paramètre évaluées pour l'élément de travail ouvert.

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" URLRoot="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>

Affichage du contenu Web

Vous pouvez utiliser l'option WebpageControl de l'attribut Type pour afficher du contenu Web dans le formulaire d'élément de travail sous la forme d'un contrôle au lieu de lier une page Web distincte. Cet affichage peut être utile pour fournir des métriques qui permettent aux membres de l'équipe de consulter le contenu d'un rapport, d'un tableau de bord ou 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 illustre comment incorporer le contenu d'une page Web en fournissant l'URL de la page à l'aide des éléments LINK et WebpageControlOptions.

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

Exemple : afficher du contenu fourni dans une balise CDATA

L'exemple suivant illustre 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>

Incorporation du guide de processus

Pour que le guide de processus soit disponible sur le formulaire d'élément de travail, vous pouvez ajouter un onglet qui contient les informations relatives au flux de travail et à l'utilisation du type d'élément de travail. Pour cela, utilisez l'option WebpageControl de l'attribut Type. Cette option fournit la prise en charge de l'incorporation de texte RTF et d'images au 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

Référence

Référence des éléments XML Control

Élément FIELD (Workflow)

Concepts

Spécification des contrôles de formulaire d'élément de travail

Définition de la disposition du formulaire d'élément de travail

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Autres ressources

Contrôle de l'affichage des champs d'éléments de travail

Historique des modifications

Date	Historique	Motif
Mai 2011	La casse de plusieurs éléments et attributs de la syntaxe XML a été corrigée. La définition de schéma pour le suivi des éléments de travail définit tous les éléments enfants de l'élément FORM en casse mixte et met en majuscule toutes les lettres qui composent les noms de tous les autres éléments.	Résolution des bogues de contenu.