Référence des éléments XML LabelText et Text

Vous pouvez ajouter une étiquette autonome ou un texte informatif à un formulaire d'élément de travail à l'aide de l'élément LabelText.L'étiquette n'est pas associée à un champ d'élément de travail.Vous pouvez éventuellement ajouter un lien hypertexte à une partie de texte ou à la totalité de celui-ci.

L'élément LabelText est un élément enfant de l'élément Control.

Hiérarchie de schéma

WITD

   WORKITEMTYPE

       FORM

           Disposition

               Groupe

               Colonne

               TabGroup

                  Onglet

                     Contrôle

<LabelText>
   <Text>
      <Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
         <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
      </Link>
      LabelText
   </Text>
</LabelText>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Éléments enfants et attributs

Élément	Description
LabelText	Élément Control requis lorsque type="LabelControl". Élément conteneur pour une étiquette autonome ou texte informatif.L'élément est de type complexe : LabelElementType. Cet élément remplace la valeur spécifiée par l'attribut Label spécifié par l'élément Control.
Text	Élément LabelText obligatoire. Élément conteneur pour les informations ou l'étiquette à afficher sur le formulaire d'élément de travail.Si l'élément Link est spécifié dans l'étiquette, la partie du texte dans l'élément est un lien hypertexte.Si l'élément Link n'est pas spécifié, le texte est restitué sans un lien hypertexte. Les parties différentes du texte d'étiquette peuvent être des liens hypertexte d'autres URL.Plusieurs valeurs d'élément de type texte peuvent être spécifiées dans une série. L'élément est de type complexe : TextElementType. Si l'élément Text n'est pas spécifié, le texte de l'attribut Label de l'élément Control apparaît sur le formulaire d'élément de travail.
Link	Élément Text facultatif. Élément conteneur pour le lien hypertexte à s'appliquer à un champ ou étiquette autonome qui apparaît sur le formulaire d'élément de travail.Le type d'élément est HyperLinkType. Remarque Vous devez spécifier l'attribut Label dans un élément Control lorsque vous spécifiez un élément Link enfant. Pour plus d'informations, consultez Référence des éléments XML Link et Param.

Éléments parents

Notes

Vous pouvez combiner du texte ordinaire et hypertexte en ajoutant plusieurs éléments Text dans un élément LabelText.

L'élément LabelText est reconnu uniquement par les clients qui exécutent la version la plus récente de Team Explorer.Par conséquent, vous devez spécifier l'attribut Label dans un élément Control.Pour les clients qui exécutent la version la plus récente de Team Explorer, le texte fourni par l'élément LabelText s'affiche dans le formulaire d'élément de travail.Pour les clients qui exécutent des versions antérieures de Team Explorer, le texte spécifié par l'élément Control de l'attribut Label s'affiche dans le formulaire d'élément de travail.

Exemple : Étiquette autonome

Description

L'exemple suivant ajoute le texte brut « Enter details about how to reproduce the bug in the space below: » (Entrez des détails sur la méthode à suivre pour reproduire le bogue dans l'espace ci-dessous :) à un formulaire d'élément de travail.

Code

<Control Type="LabelControl" Label=" Enter details about how to reproduce the bug in the space below:">
   <LabelText>
      <Text>Enter details about how to reproduce the bug in the space below:
      </Text>
   </LabelText>
</Control>

Exemple : Étiquette autonome avec le lien hypertexte

Description

L'exemple suivant ajoute un lien hypertexte qui est étiqueté « Comment faire pour utiliser cet élément de travail ? » à un formulaire d'élément de travail.

Code

<Control Type="LabelControl" Label="How do I use this work item?">
   <LabelText>
      <Text>
   <Link UrlRoot="http://www.live.com"></Link>
      How do I use this work item?
      </Text>
   </LabelText>
</Control>

Exemple : Le lien hypertexte s'appliqué aux parties de texte

Description

L'exemple suivant ajoute une étiquette en deux parties à un formulaire d'élément de travail.La première partie, "Chemin de l'itération", est associée à un lien hypertexte.La deuxième partie "(must be 3 levels deep)" apparaît sur le formulaire d'élément de travail sous forme de texte brut.

Code

<Control Type="FieldControl" FieldName="System.IterationPath" LabelPosition="Left">
   <LabelText>
      <Text>
         <Link UrlRoot="@WssSiteUrl/render.aspx?wit=bug&amp;topic=Iteration">
         </Link>
      Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Définitions de schéma

Élément : LabelText

<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />

Type complexe : LabelElementType

<xs:complexType name="LabelElementType">
   <xs:sequence>
      <xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
   </xs:sequence>
</xs:complexType>

Type complexe : TextElementType

<xs:complexType name="TextElementType" mixed="true">
   <xs:sequence>
      <xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
   </xs:sequence>
</xs:complexType>

Voir aussi

Concepts

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

Concevoir et personnaliser un formulaire d'élément de travail

Autres ressources

Elements (Work Item Type Definition Schema)