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

Vous pouvez utiliser les informations fournies dans cette rubrique comme une référence rapide à l'élément Control, y compris ses éléments enfants et ses attributs. Pour chaque champ ou contrôle de formulaire que vous souhaitez afficher sur un formulaire d'élément de travail, vous ajoutez un élément Control. Vous pouvez personnaliser un formulaire d'élément de travail de manière à afficher des informations destinées à aider votre équipe à l'utiliser correctement. Vous pouvez ajouter les champs et contrôles d'élément de travail qui vous permettent d'entrer et de consulter les données dont vous voulez effectuer le suivi. L'élément Control fournit neuf valeurs pour l'attribut Type que vous pouvez utiliser pour ajouter des champs ou pour afficher du texte ou des champs au format brut ou hypertexte. En outre, vous pouvez définir des contrôles spéciaux pour ajouter des liens et des pièces jointes et afficher du contenu Web ou vous pouvez créer votre propre contrôle et l'ajouter à un formulaire d'élément de travail.

Dans cette rubrique

• Ajout de champs d'élément de travail à un formulaire d'élément de travail

• Ajout de contrôles spéciaux à un formulaire d'élément de travail

• Ajout de contrôles personnalisés à un formulaire d'élément de travail

Ajout de champs d'élément de travail à un formulaire d'élément de travail

Lorsque vous personnalisez votre formulaire d'élément de travail, vous ajoutez en général un sous-ensemble des champs d'élément de travail qui sont définis pour le type d'élément de travail que vous souhaitez voir figurer sur le formulaire. Les définitions de champ contrôlent de nombreux aspects relatifs aux données à afficher ou aux données pouvant être entrées dans le formulaire. Pour plus d'informations, consultez Définition des champs d'éléments de travail.

Chaque champ d'élément de travail est associé à un type de données. Vous pouvez utiliser les informations du tableau suivant pour déterminer le type de champ pris en charge en fonction de l'attribut Type de l'élément Control. L'attribut Label permet de spécifier le texte qui s'affiche en regard du contrôle. L'attribut LabelPosition permet de spécifier l'emplacement de cette étiquette par rapport au contrôle. Pour plus d'informations, consultez Contrôle de l'affichage des champs d'éléments de travail.

Notes

Vous ne pouvez pas modifier les valeurs des champs système, lesquels sont mis à jour automatiquement. Par exemple, les champs Date de création et Créé par sont définis lorsqu'un élément de travail est enregistré pour la première fois. Vous pouvez cependant utiliser ces champs dans des critères de recherche. Pour obtenir une description de chaque champ système, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF.

Type de champ	Attribut Type de l'élément Control	Utilisation
DateTime	FieldControl DateTimeControl	Utilisez FieldControl afin de fournir un champ de texte pour l'entrée ou l'affichage d'un champ de type de données DateTime. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> Utilisez DateTimeControl afin de fournir un sélecteur de calendrier pour sélectionner la date d'un champ, comme indiqué dans l'illustration suivante. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	Utilisez FieldControl afin de fournir un champ de texte pour l'entrée ou l'affichage de champs de type Double. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
Historique	WorkItemLogControl	Vous utilisez WorkItemLogControl afin de fournir un champ de contrôle pour les champs historiques qui suivent les thèmes de discussion et d'autres données historiques, comme indiqué dans l'illustration suivante. Vous pouvez utiliser ce contrôle uniquement pour prendre en charge l'affichage du champ historique d'un élément de travail, System.History. À l'aide de ce contrôle, vous pouvez développer et réduire les détails de l'historique des révisions d'un élément de travail. Vous pouvez également mettre en forme le texte que vous ajoutez dans le champ historique. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	Utilisez HTMLControl afin de fournir un champ de contrôle qui permette aux champs de type HTML de capturer la mise en forme de texte enrichi, comme indiqué dans l'illustration suivante. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	Utilisez FieldControl afin de fournir un champ de contrôle pour un champ de type Integer. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Utilisez FieldControl afin de fournir un champ de contrôle pour un champ de type PlainText, par exemple, une zone de texte qui contient des descriptions de plus de 255 caractères. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	Utilisez FieldControl afin de fournir un champ de contrôle pour un champ de type String. Les champs de ce type sont limités à 255 caractères. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	Utilisez WorkItemClassificationControl afin de fournir un champ de contrôle pour un champ de type TreePath. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Attributs facultatifs de champ d'élément Control pour tous les types de contrôles

Les attributs facultatifs suivants peuvent être spécifiés uniquement pour les types de contrôles répertoriés.

Attribute	Description
Field	Spécifie le contrôle qui est associé au champ d'élément de travail.
Label	Spécifie le texte visible sur le formulaire qui identifie le contrôle. Spécifiez une chaîne de moins de 80 caractères. Remarque Vous pouvez attacher un lien hypertexte à l'étiquette d'un champ ajouté au formulaire d'élément de travail à l'aide de FieldControl.Ce contrôle permet de fournir un lien vers les informations relatives à l'utilisation du champ.Pour plus d'informations, consultez Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail.
LabelPosition	Spécifie la position de l'étiquette par rapport aux données de contrôle. Spécifiez une chaîne à partir de l'une des valeurs suivantes : Top, Bottom, Left et Right.
Dock	Spécifie l'alignement de l'étiquette par rapport au côté indiqué du conteneur, ou étire le champ pour remplir le conteneur. Spécifiez une chaîne à partir de l'une des valeurs suivantes : Fill, Top, Bottom, Left et Right.
Padding	Spécifie la quantité d'espace, en pixels, autour de la bordure interne du contrôle. Quatre valeurs qui correspondent aux bords supérieur, inférieur, gauche et droit sont fournies. Par exemple : (2,0,2,0).
Margin	Spécifie la quantité d'espace, en pixels, autour de la bordure externe du contrôle. Quatre valeurs qui correspondent aux bords supérieur, inférieur, gauche et droit sont fournies. Par exemple : (2,0,2,0).
ReadOnly	Spécifie que le champ est en lecture seule. Spécifiez True ou False.
MinimumSize	Spécifie la taille minimale, en pixels, que le contrôle doit occuper dans le formulaire. Deux valeurs qui correspondent à la largeur et la hauteur sont spécifiées. Par exemple : (100,100).
Name	Identifie un contrôle de manière unique. L'attribut Name est obligatoire si plusieurs contrôles du formulaire sont associés au même champ d'élément de travail. Remarque Vous utilisez l'attribut Name pour afficher le même champ dans plusieurs zones du formulaire.Vous spécifiez une valeur unique pour l'attribut Name des deux entrées de contrôle afin que le système identifie chaque contrôle de manière unique.Il est utile d'afficher le même contrôle à différents emplacements en fonction du contexte des onglets.

Attributs facultatifs de champ d'élément Control pour certains types de contrôles

Les attributs facultatifs suivants peuvent être spécifiés uniquement pour les types de contrôles répertoriés.

Attribute	Type de contrôle	Description
NumberFormat	FieldControl	Spécifie les caractères que vous pouvez entrer dans le contrôle de champ. Les valeurs suivantes sont valides : WholeNumbers, SignedWholeNumbers, DecimalNumbers et SignedDecimalNumbers.
MaxLength	FieldControl	Spécifie la longueur maximale des caractères que vous pouvez utiliser pour un contrôle de champ.
Format	DateTimeControl	Spécifie le format du champ date-heure qui correspond à une valeur de l'enum DateTimePickerFormat. Les valeurs suivantes sont valides : Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Spécifie le format personnalisé du champ date-heure qui correspond à la syntaxe définie pour la propriété DateTimePicker.CustomFormat.

Ajout de contrôles spéciaux à un formulaire d'élément de travail

Le tableau suivant décrit les attributs Type de l'élément Control qui vous permettent de gérer l'ajout de fichiers joints, de créer des liens et d'afficher du contenu Web et d'autres données non associées à un champ d'élément de travail.

Attribut Type de l'élément Control	Utilisation
AttachmentsControl	Permet de joindre des fichiers à un formulaire d'élément de travail. Ce contrôle figure généralement dans son propre groupe d'onglets, comme indiqué dans l'illustration suivante. AttachmentsControl Pour plus d'informations, consultez Ajout de AttachmentsControl.
LabelControl	Permet d'afficher du texte au format brut ou hypertexte qui n'est pas associé à un champ, comme indiqué dans l'illustration suivante. Vous utilisez les éléments conteneur et enfants LabelText et Link afin de spécifier le texte, le lien hypertexte et la position d'un champ ou d'une étiquette dont le texte est associé en partie à un lien hypertexte. Pour plus d'informations, consultez Ajout de texte d'aide, guide de processus, contenu Web et liens vers les pages Web sur un formulaire d'élément de travail, Référence des éléments XML LabelText et Text et Référence des éléments XML Link et Param.
LinksControl	Permet de créer et gérer des liens entre des éléments de travail. Ce contrôle figure généralement dans son propre groupe d'onglets, comme indiqué dans l'illustration suivante. Vous utilisez LinksControlOptions pour définir les filtres de liens et la disposition des champs de colonne permettant d'afficher la liste des liens. Pour plus d'informations, consultez Définition des contrôles de liens pour restreindre les relations de liens et Éléments LinksControlOptions.
WebpageControl	Permet d'afficher du contenu Web dans un formulaire d'élément de travail. Ce contrôle se trouve généralement dans son propre groupe d'onglets. Vous utilisez les éléments enfants WebpageControlOptions et Link afin de spécifier les contrôles requis pour charger la cible de la page Web dans le formulaire d'élément de travail. Pour plus d'informations, consultez Ajout de contenu Web à un formulaire d'élément de travail, Référence des éléments XML WebpageControlOptions et Référence des éléments XML Link et Param.

Ajout de contrôles personnalisés à un formulaire d'élément de travail

Outre les contrôles intégrés, vous pouvez ajouter votre contrôle personnalisé à un formulaire d'élément de travail.

Par exemple, vous pouvez ajouter un contrôle personnalisé pour obtenir une capture d'écran à partir du Presse-papiers. Vous pouvez également fournir un contrôle permettant de capturer plusieurs valeurs en ajoutant une case à cocher pour les valeurs qui sont présentées dans une liste ou un menu.

Pour implémenter un contrôle personnalisé, vous devez spécifier le nom du contrôle pour l'attribut Type. Pour plus d'informations, consultez le site Web Microsoft : Contrôles personnalisés de suivi d'élément de travail (éventuellement en anglais).

Voir aussi

Tâches

Ajouter et personnaliser un type d'élément de travail

Modification de la disposition du formulaire d'élément de travail

Modification de l'étiquette d'un champ

Ajout de contenu Web à un formulaire d'élément de travail

Référence

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

Concepts

Conception et personnalisation d'un formulaire d'élément de travail

Historique des modifications

Date	Historique	Motif
Juin 2010	Des illustrations ont été ajoutées et certaines sections ont été déplacées dans de nouvelles rubriques.	Améliorations apportées aux informations.