Fournir un texte d'aide, un guide de processus, un contenu Web et des 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 du formulaire ou les rendre facilement disponibles, les membres de l'équipe pourront mieux suivre des informations 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.

Modifiez le formulaire d'élément de travail en modifiant la définition du type d'élément de travail.Vous pouvez utiliser l'outil en ligne de commande des witadmin, consultez Personnaliser et gérer des types d'éléments de travail (witadmin), ou process editor.

L'éditeur de processus est un complément d'outil puissant de Visual Studio que vous pouvez télécharger et installer.Situé sous le menu Outils, process editor fournit une interface utilisateur graphique pour personnaliser les objets utilisés aux éléments de travail dans Team Foundation Server.Vous pouvez utiliser cet outil pour importer et exporter des types d'éléments de travail et pour modifier leurs définitions.Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Outils de gestion de l'alimentation Team Foundation Server.

Fournissez le texte d'aide ou le 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>

Ajoutez les étiquettes autonomes de texte 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>

[!REMARQUE]

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 2012, 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 le lien hypertexte pour 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 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

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 : paramètre- générée étiquette de champ Lien hypertexte

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://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" Value="System.State" Type ="Original"/>
   </Link>
</Control>

Affichage du contenu de site 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="true">
               <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>

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

Concepts

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

Personnaliser les données de suivi de projet, les formulaires, les flux de travail et d'autres objets