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.

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.

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.

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)" />

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.

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" />

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