Élément FIELD (Définition)

Utilisez l'élément FIELD (Définition) pour définir un champ d'élément de travail et spécifier les règles et conditions qui lui sont appliquées. Les attributs que vous assignez à un champ déterminent leur mode d'affichage dans un formulaire d'élément de travail et leur disponibilité pour l'inclusion dans les états. Vous gérez l'ensemble des assignations de champs pour une collection de projets d'équipe. Par conséquent, les attributs que vous assignez aux champs qui sont définis dans un type d'élément de travail doivent être les mêmes pour tous les types d'éléments de travail de tous les projets d'équipe d'une collection. En outre, tous les champs signalables de toutes les collections sont exportés dans les bases de données des entrepôts de données.

Vous pouvez modifier les assignations d'attribut aux champs existants pour une collection à l'aide de l'outil de commande witadmin. Pour plus d'informations, consultez Gestion des champs d'éléments de travail (witadmin).

Hiérarchie de schéma

WITD

   WORKITEMTYPE

      FIELDS

            FIELD

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
name	Obligatoire. Nom convivial du champ qui apparaît dans les menus déroulants des requêtes d'éléments de travail. Le nom convivial doit être unique pour tous les champs qui sont définis dans un projet d'équipe. En outre, le nom convivial peut différer du nom qui apparaît à côté du champ sur le formulaire de l'élément de travail. Pour plus d'informations, consultez Référence des éléments XML Control. Le type de l'attribut est typelib:FieldName. Longueur minimale : 1 ; longueur maximale : 128. Valeur de modèle : ^[^\. \[\]]+$ Exemple de valeur de modèle : Assigné à
refname	Obligatoire. Nom unique qui distingue un champ de tous les autres champs qui sont définis dans la collection de projets d'équipe. Pour des spécifications et restrictions supplémentaires sur les noms conviviaux et les noms de référence, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail. Le type de l'attribut est typelib:ReferenceFieldName. Longueur minimale : 1 ; longueur maximale : 70. Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Exemple de valeur de modèle : Company.IssueType
type	Obligatoire. Spécifie le type de données que le champ accepte. Remarque Des champs dans différentes collections de projets ayant la même valeur reportingrefname doivent être assignés de la même valeur pour type.Si les valeurs diffèrent, des conflits de données peuvent se produire quand l'entrepôt de données est traité.Pour plus d'informations, consultez Résolution de conflits de schéma qui se produisent dans l'entrepôt de données. Le tableau suivant répertorie les valeurs valides pour cet attribut : ValeurUtilisation DateTime Spécifie une date basée sur le temps universel coordonné (UTC, Coordinated Universal Time). Double Spécifie une valeur à virgule flottante. GUID Spécifie un champ qui doit contenir un identificateur unique. History Prend en charge des thèmes de discussion et effectue le suivi d'autres informations d'historique. Remarque Le champ System.History est le seul champ qui utilise ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données. HTML Prend en charge la capture de données de texte enrichi et est utilisé pour des descriptions textuelles longues telles qu'une description d'élément de travail. Integer Spécifie une valeur entière signée 32 bits. PlainText Prend en charge la saisie d'une chaîne de texte qui peut contenir plus de 255 caractères Unicode. String Prend en charge la saisie d'une chaîne de texte qui peut contenir jusqu'à 255 caractères Unicode.Utilisez un champ de type String pour une étiquette ou toute autre chaîne de texte courte d'une ligne au maximum. TreePath Spécifie un champ qui affiche des entrées dans une structure hiérarchique ou d'arborescence, telle que ce qui est obligatoire pour afficher les chemins de la zone et de l'itération pour un produit. Remarque Les champs System.AreaPath et System.IterationPath sont les seuls champs qui utilisent ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données.
syncnamechanges	Facultatif. Spécifie si le champ d'élément de travail est utilisé pour stocker des noms que vous souhaitez mettre à jour lorsque des modifications sont apportées dans Active Directory ou un groupe de travail. Cette option est valide uniquement lorsque type="String". Le type de l'attribut est xs:boolean. Spécifiez true pour permettre la synchronisation du champ de données, spécifiez false pour désactiver la synchronisation du champ de données.
reportable	Facultatif. Indique si les données du champ sont disponibles pour l'inclusion dans les états. Des champs dont la valeur par défaut est None ne sont pas exportés dans l'entrepôt de données relationnelles, ni traités pour le cube Analysis Services de SQL Server. Pour plus d'informations sur les champs signalables, consultez Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports. Remarque Des champs dans différentes collections de projets ayant la même valeur reportingrefname doivent être assignés de la même valeur pour reportable.Si les valeurs diffèrent, des conflits de données peuvent se produire quand l'entrepôt de données est traité.Pour plus d'informations, consultez Résolution de conflits de schéma qui se produisent dans l'entrepôt de données. Le tableau suivant répertorie les valeurs valides pour cet attribut : Value Utilisation Detail Peut être spécifié pour les champs de type Date/Heure, Double, Entier ou Chaîne. Les données de ce champ sont déplacées dans les tables Élément de travail et Élément de travail actif en cours de la base de données relationnelle, mais pas dans le cube Analysis Services.Le choix de ce type est judicieux pour les champs de texte illimités parce que vous pouvez les utiliser dans les états sans trop augmenter la taille du cube. Dimension Peut être spécifié pour les champs de type Date/Heure, Double, Entier ou Chaîne. Les données de ce champ entrent dans la base de données relationnelle et le cube Analysis Services en tant qu'attribut de la dimension Élément de travail afin que les données puissent être utilisées pour filtrer les rapports.Utilisez ce type pour les champs contenant des listes de valeurs valides.Type d'élément de travail et État sont de bons exemples de dimension. Measure Utilisez uniquement le type de mesure pour les champs Entier et Double.Les mesures sont les valeurs numériques contenues dans vos rapports.Lorsque le cube Analysis Services est traité, les données sont pré-calculées sur les champs dont les attributs reportable ont la valeur Measure.Par exemple, les groupes de mesures Élément de travail et Élément de travail actif contiennent des données cumulatives pour les champs suivants : Estimation d'origine, Heures restantes et Heures effectuées.Lorsque vous spécifiez la mesure, vous devez spécifier l'attribut formula. None Spécifiez None quand vous ne voulez pas utiliser le champ pour l'inclusion dans les états.Il s'agit de l'affectation par défaut.
formula	Facultatif. Type d'agrégation pour le type reportable measure. La seule valeur valide est sum, qui retourne la somme de toutes les valeurs du jeu.
reportingname	Facultatif. Spécifie le nom qui apparaît dans les états. Si vous ne spécifiez pas de valeur, la valeur assignée à l'attribut name est utilisée. Remarque Des champs dans différentes collections de projets ayant la même valeur reportingrefname doivent être assignés de la même valeur pour reportingname.Si les valeurs diffèrent, des conflits de données peuvent se produire quand l'entrepôt de données est traité.Pour plus d'informations, consultez Résolution de conflits de schéma qui se produisent dans l'entrepôt de données. Le type de l'attribut est typelib:FieldName. Longueur minimale : 1 ; longueur maximale : 128. Valeur de modèle : ^[^\. \[\]]+$ Exemple de valeur de modèle : Assigné à
reportingrefname	Facultatif. Spécifie le nom de référence utilisé lorsque un champ signalable est traité. Si vous ne spécifiez pas de valeur, la valeur assignée à l'attribut refname est utilisée. Vous pouvez utiliser cet attribut pour fusionner ou séparer les champs qui sont traités dans l'entrepôt de données. Pour fusionner deux champs qui ont des noms de référence distincts et qui sont définis dans différentes collections de projets, assignez le même nom reportingrefname à chacun d'eux. Pour différencier deux champs ayant le même nom de référence et étant définis dans des collections de projets différentes, vous assignez un attribut reportingrefname distinct à chacun d'eux. Vous devez fusionner les champs dès que possible pour réduire le nombre de champs dans l'entrepôt et le conserver sous la limite des 1 024 champs signalables. Vous pouvez générer des rapports intergroupes avec des champs fusionnés. Le type de l'attribut est typelib:ReferenceFieldName. Longueur minimale : 1 ; longueur maximale : 70. Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Exemple de valeur de modèle : Company.IssueType

Éléments enfants

Éléments parents

Notes

FIELD (définition) est un élément enfant requis de FIELDS (définition).

minOccurs="1"

Vous ne pouvez pas définir plus de 1 024 champs d'éléments de travail dans la même collection de projets d'équipe, et vous ne pouvez pas définir plus de 1 024 champs signalables dans toutes les collections de projets d'équipe. Pour plus d'informations, consultez Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports.

Pour des spécifications et restrictions supplémentaires sur les noms conviviaux de champ et les noms de référence, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail. Pour plus d'informations sur le mode d'étiquetage des champs à des fins de requête, consultez Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports.

Vous ne pouvez pas définir de champ personnalisé commençant par le préfixe System.. Vous pouvez définir un champ en utilisant le préfixe Microsoft., toutefois, cette pratique est fortement déconseillée, car elle peut entraver les fonctionnalités Team Foundation Server.

Pour une vue d'ensemble de l'objet du suivi de l'élément de travail du champ, consultez Utilisation des champs d'élément de travail.

Pour une vue d'ensemble de tous les champs système et prédéfinis définis pour le Microsoft Solutions Framework (MSF) pour le modèle de processus Agile Software Development v5.0, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF.

Les noms de référence de champ ne peuvent pas être renommés. Vous pouvez répertorier des champs, ainsi que modifier le nom convivial et les attributs d'un champ à l'aide de l'outil en ligne de commande witadmin. Pour plus d'informations, consultez Gestion des champs d'éléments de travail (witadmin).

Pour plus d'informations sur le mode d'utilisation des champs à travers les collections de projets d'équipe, consultez Résolution de conflits de schéma qui se produisent dans l'entrepôt de données et Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports.

Exemple

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

Voir aussi

Référence

Gestion des champs d'éléments de travail (witadmin)

Concepts

Conventions d'affectation de noms pour les objets de suivi des éléments de travail

Utilisation de champs système et de champs définis par les modèles de processus MSF

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Utilisation des champs d'élément de travail

Autres ressources

Index des définitions d'éléments XML pour les types d'éléments de travail

Historique des modifications