Spécifier des contrôles de formulaire d'élément de travail
Cette rubrique fournit un aide-mémoire sur l'élément Control, 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.
Ajouter des champs 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 Modifier ou ajouter un champ pour prendre en charge les requêtes, les rapports et le flux 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ôler 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 Référence des champs d'éléments de travail pour Visual Studio ALM.
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. Utilisez DateTimeControl afin de fournir un sélecteur de calendrier pour sélectionner la date d'un champ, comme indiqué dans l'illustration suivante. .png "Champ Calendrier")
|
Double |
FieldControl |
Utilisez FieldControl afin de fournir un champ de texte pour l'entrée ou l'affichage de champs de type Double. |
History |
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. .png "Onglet et champ Historique du formulaire d'élément de travail")
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. |
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. .png "Champ HTML affiché dans le formulaire d'élément de travail")
|
Integer |
FieldControl |
Utilisez FieldControl afin de fournir un champ de contrôle pour un champ de type Integer. |
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. |
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. |
TreePath |
WorkItemClassificationControl |
Utilisez WorkItemClassificationControl afin de fournir un champ de contrôle pour un champ de type TreePath. |
Attributs facultatifs de champ d'élément Control pour tous les types de contrôle
Les attributs facultatifs suivants peuvent être spécifiés uniquement pour les types de contrôles répertoriés.
Attribut |
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. Notes 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 Fournir du texte d'aide, des liens hypertexte ou du contenu 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. Notes 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ôle
Les attributs facultatifs suivants peuvent être spécifiés uniquement pour les types de contrôles répertoriés.
Attribut |
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. |
Ajouter des contrôles spéciaux
Le tableau suivant décrit les attributs Control de l'élément Type 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. Contrôle Attachments .png "Joindre des fichiers à un élément de travail")
Pour plus d'informations, consultez Ajouter le contrôle Pièces jointes. |
LabelControl |
Permet d'afficher du texte au format brut ou hypertexte qui n'est pas associé à un champ, comme indiqué dans l'illustration suivante. .png "Exemple de deux liens hypertexte appliqués au texte")
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 Fournir du texte d'aide, des liens hypertexte ou du contenu 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. .png "Exemple d'un contrôle de liens ajouté à un formulaire d'élément de travail")
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éfinir 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 Modifier une définition WIT pour ajouter du 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. |
Ajouter des contrôles personnalisés
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.
Voir aussi
Tâches
Modifier la disposition du formulaire d'élément de travail
Modifier une définition WIT pour ajouter du contenu Web à un formulaire d'élément de travail