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

Vous pouvez contrôler le nom d'étiquette, la position, la taille de zone de texte, et d'autres contrôles d'affichage de champs de texte brut, entier, nombre, date et élément de travail de chemin d'arborescence sur votre formulaire d'élément de travail. Pour afficher ces champs, vous devez spécifier l'attribut Control approprié de l'élément Type, à partir des options suivantes :

• DateTimeControl : utilisé pour afficher les champs de date mis en forme qui ont un type de champ DateTime.

• FieldControl : utilisé pour afficher les champs de texte brut ou numériques et les listes de valeurs pour les champs ayant un type de champ String, Identity, Integer, Double et PlainText.

• HtmlFieldControl : utilisé pour afficher le format RTF multiligne des champs qui ont un type de données de champ HTML.

• WorkItemClassificationControl : utilisé pour afficher les champs de chemin d'accès hiérarchiques qui ont un type de champ TreePath.

Pour plus d'informations sur les autres contrôles Type, consultez les rubriques suivantes :

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

• Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail

• Définir des contrôles de liens pour restreindre les relations de liens

• Ajouter le contrôle Pièces jointes

Dans cette rubrique

• Contrôler la taille et l'affichage des champs de données

• Affecter des étiquettes aux champs et ajouter des champs à deux emplacements du formulaire

• Définir un champ en lecture seule

• Ajouter des champs de texte brut et numériques

• Ajouter des champs de texte mis en forme

• Ajouter des champs de date ou de calendrier

• Ajouter des champs pour les chemins d'accès à la zone et à l'itération

Contrôler la taille et l'affichage des champs de données

Vous pouvez contrôler l'espacement et la taille de chaque champ de données en utilisant les attributs facultatifs décrits dans le tableau suivant.

Notes

La taille globale de chaque champ d'entrée de données est déterminée par plusieurs facteurs : les attributs assignés au champ, la taille du conteneur, et la zone allouée aux autres champs sur le formulaire.Les valeurs par défaut sont assignées aux champs lorsque vous ne spécifiez pas de taille minimale.Toutefois, les attributs assignés aux autres champs du formulaire peuvent affecter la taille des champs.Le nombre de colonnes et la taille horizontale que vous allouez au plus grand champ de chaque colonne déterminent la dimension horizontale d'un formulaire.Le nombre de champs que vous spécifiez dans un groupe vertical et la taille verticale que vous allouez à chaque champ déterminent la taille du haut du formulaire et la taille du bas du formulaire.

Attribut	Description	Exemple de valeur de modèle
MinimumSize	Indique la taille minimale (Largeur, Hauteur) du contrôle. Lorsque le conteneur pour le contrôle est inférieur à cette taille, des barres de défilement horizontale et verticale apparaissent.	(100,100)
Margin	Spécifie, en pixels, la quantité d'espace autour du contrôle et entre le contrôle et ses voisins (haut, bas, gauche, droite).	(2,0,2,0)
Padding	Spécifie, en pixels, la quantité d'espace autour de la bordure externe du contrôle (haut, bas, gauche, droite).	(2,0,2,0)

Affecter des étiquettes aux champs et ajouter des champs à deux emplacements du formulaire

Pour chaque contrôle de formulaire, vous pouvez spécifier une étiquette facultative et la position de l'étiquette à l'aide des attributs Label et LabelPosition. L'étiquette peut spécifier un nom différent du nom convivial assigné par l'élément FIELD. Si vous ne spécifiez pas d'étiquette, le nom convivial est utilisé. Toutefois, notez que le nom convivial est toujours utilisé lorsqu'un membre de l'équipe exécute une requête pour rechercher des éléments de travail. La taille d'étiquette maximale est de 80 caractères.

Notes

Vous devez définir la même position d'étiquette pour tous les contrôles définis dans le même groupe.

Si vous souhaitez ajouter le champ dans plusieurs zones du formulaire, par exemple en haut du formulaire et sous un onglet, vous pouvez le faire à l'aide de l'attribut Name. L'attribut Name identifie simplement le contrôle comme différent de l'autre contrôle ajouté au formulaire.

Définir un champ en lecture seule

Vous pouvez marquer un champ en lecture seule de l'une des deux façons suivantes. Dans la première méthode, vous ajoutez l'élément READONLY en tant qu'enfant à l'élément FIELD dans la section FIELDS de la définition de type. En utilisant l'élément READONLY, vous pouvez spécifier si certains utilisateurs peuvent modifier le champ. Comme indiqué dans l'exemple suivant, seuls les chefs de projet peuvent modifier un champ Sous-titre.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

Dans la seconde méthode, vous spécifiez l'attribut ReadOnly pour l'élément CONTROL. Dans cette méthode, aucun utilisateur n'a le droit de modifier le champ.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Ajouter des champs de texte et numériques

Vous utilisez le type FieldControl pour ajouter des champs de texte brut et numériques à un formulaire. Cet attribut est également utilisé pour ajouter des listes de choix ; des champs utilisés pour afficher des noms de personnes, tels que les champs Assigné à ou Propriétaire ; et des nombres entiers et réels. Le contrôle de champ doit renvoyer à un champ de par son nom de référence. L'étiquette de champ peut être du texte brut ou un lien hypertexte. Pour plus d'informations, consultez Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail.

Champs Texte, Entier et Liste de choix

Vous pouvez contrôler le format des champs numériques et la longueur maximale des caractères qui peuvent être entrés dans un champ textuel ou numérique à l'aide des attributs facultatifs décrits dans le tableau suivant.

Attribut	Description
NumberFormat	Spécifie les caractères que vous pouvez entrer dans le contrôle de champ. Les valeurs valides sont les suivantes : WholeNumbers, SignedWholeNumbers, DecimalNumbers et SignedDecimalNumbers.
MaxLength	Spécifie la longueur maximale des caractères que vous pouvez utiliser pour un contrôle de champ.

Le code suivant répertorie la syntaxe utilisée pour créer le groupe de champs illustré précédemment.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Ajouter des champs de texte mis en forme

Vous utilisez le type HTMLFieldControl afin d'ajouter des champs dont le type de données est HTML. Ce contrôle prend en charge l'affichage du texte mis en forme sur plusieurs lignes.

Champ HTML

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" MinimumSize="(100,500)" />

Conseil

Lorsque vous ajoutez plusieurs éléments HTMLFieldControl sur un formulaire qui sera empilé verticalement, vous devez spécifier l'attribut MinimumSize pour chaque contrôle de champ.Ainsi, vous pouvez donner la même taille à toutes les zones de texte.Sinon, le dernier élément de contrôle HTML est dimensionné pour remplir le formulaire, et les éléments précédents s'affichent avec des zones de texte plus petites.

Ajouter des champs de date ou de calendrier

Vous utilisez le type DateTimeControl pour fournir aux utilisateurs un sélecteur de calendrier afin de sélectionner une date pour un champ DateTime. À l'aide de ce contrôle, vous pouvez sélectionner rapidement une date et une heure pour le champ.

Champ de calendrier avec Format="Short"

Par exemple, vous pouvez spécifier une date de début par défaut ou une date de révision ultérieure.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

Vous pouvez contrôler le format du champ DateTime à l'aide des attributs facultatifs décrits dans le tableau suivant.

Attribut	Description
Format	Spécifie le format du champ date-heure qui correspond à une valeur de l'enum DateTimePickerFormat. Les valeurs valides sont les suivantes : Custom, Long, Short et Time. Lorsque vous spécifiez Custom, vous devez également spécifier l'attribut CustomFormat.
CustomFormat	Spécifie le format personnalisé du champ date-heure qui correspond à la syntaxe définie pour la propriété DateTimePicker.CustomFormat. Par exemple : Format="Custom" CustomFormat = « dd MMM, 'de l'année' yyyy » Pour plus d'informations, consultez le site web de Microsoft : Propriété DateTimePicker.CustomFormat.

Ajouter des champs pour les chemins d'accès à la zone et à l'itération

Vous utilisez le type WorkItemClassificationControl afin d'ajouter des champs dont le type de données est TreePath. Ce contrôle prend en charge l'affichage des champs du chemin d'accès de zone et des champs du chemin d'accès d'itération dans un format d'arborescence imbriquée hiérarchique. L'arborescence affiche des nœuds hiérarchiques que vous pouvez développer et réduire.

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

Notes

Vous pouvez utiliser le WorkItemClassificationControl pour afficher les champs System.AreaPath et System.IterationPath.Vous ne pouvez afficher aucun autre type de champ ou champ personnalisé à l'aide de ce contrôle.

Pour plus d'informations, consultez Ajouter et modifier des chemins de zone et d'itération.

Voir aussi

Concepts

Ajouter et modifier des champs d'éléments de travail pour prendre en charge la création de rapports

Ajouter le contrôle Pièces jointes

Définir des contrôles de liens pour restreindre les relations de liens

Autres ressources

Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail