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

Article
11/18/2015

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 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. `<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" />`
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. 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ô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 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. 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. 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.
StoryboardsControl	Permet d'ouvrir un plan conceptuel PowerPoint à partir d'un élément de travail et d'établir une liaison avec des fichiers de plan conceptuel enregistrés sur un partage réseau. Ce contrôle figure généralement dans son propre groupe d'onglets, comme indiqué dans l'illustration suivante. Pour ajouter le contrôle StoryboardsControl à la section FORM, ajoutez l'extrait de code suivant : <Tab Label="Storyboards"> <Control Name="StoryboardsControl" Type="LinksControl"> <LinksControlOptions> <WorkItemLinkFilters FilterType="excludeAll" /> <ExternalLinkFilters FilterType="include"> <Filter LinkType="Storyboard" /> </ExternalLinkFilters> <LinkColumns> <LinkColumn RefName="System.Title" /> <LinkColumn LinkAttribute="System.Links.Comment" /> </LinkColumns> </LinksControlOptions> </Control> </Tab>
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

Référence

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

Partager via