Partager via

Élément FIELD (Définition)

  • Article

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.

Notes

Pour plus d'informations sur l'élément FIELD (flux de travail) que vous utilisez pour spécifier les règles et les conditions des champs pendant un changement d'état ou de transition du flux de travail, consultez Élément FIELD (Workflow).

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.

RemarqueRemarque
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.
RemarqueRemarque
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.
RemarqueRemarque
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.

RemarqueRemarque
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.

RemarqueRemarque
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ément

Description

ALLOWEDVALUES

Facultatif. Définit une liste de valeurs autorisées pour le champ. Les valeurs autorisées correspondent aux valeurs pouvant être choisies dans une liste de champs figurant sur les formulaires d'élément de travail et dans le Générateur de requêtes. Vous devez sélectionner l'une de ces valeurs.

ALLOWEXISTINGVALUE

Facultatif. Définit le champ pour autoriser des valeurs existantes. Cet élément permet aux valeurs de champ déjà existantes d'être utilisées, même si elles ne sont pas valides. Toutes les nouvelles valeurs de champ doivent être valides.

CANNOTLOSEVALUE

Facultatif. Définit le champ comme ne pouvant pas perdre sa valeur. Cet élément garde la valeur de champ actuelle et il ne peut pas être effacé ou vidé.

COPY

Facultatif. Spécifie un autre champ qui contient une valeur à copier dans le champ actuel.

DEFAULT

Facultatif. Définit une valeur par défaut pour le champ.

EMPTY

Facultatif. Définit le champ comme étant vide.

FROZEN

Facultatif. Définit le champ comme étant figé. Il n'est plus possible d'affecter à un champ figé une valeur non vide une fois les modifications validées. Vous pouvez toutefois effacer le champ manuellement, enregistrer l'élément de travail, puis spécifier une valeur différente.

HELPTEXT

Facultatif. Définit le texte affiché dans l'info-bulle pour le champ.

MATCH

Facultatif. Définit un modèle pour le champ auquel la valeur du champ doit correspondre.

NOTSAMEAS

Facultatif. Spécifie un autre champ dont la valeur ne peut pas être identique à la valeur du champ actuel.

PROHIBITEDVALUES

Facultatif. Définit une liste de valeurs interdites pour le champ.

READONLY

Facultatif. Définit le champ comme étant en lecture seule.

REQUIRED

Facultatif. Définit le champ comme obligatoire.

SERVERDEFAULT

Facultatif. Spécifie un composant serveur qui fournit la valeur du champ.

SUGGESTEDVALUES

Facultatif. Définit une liste de valeurs suggérées pour le champ. Les valeurs suggérées correspondent aux valeurs pouvant être choisies dans une liste de champs figurant sur les formulaires d'élément de travail et dans le Générateur de requêtes. Vous pouvez entrer d'autres valeurs en plus de celles indiquées dans la liste.

VALIDUSER

Facultatif. Spécifie que la liste de valeurs autorisées ne doit comporter que des utilisateurs valides du système.

WHEN

Facultatif. Spécifie une ou plusieurs règles à appliquer au champ actuel lorsqu'un autre champ a une valeur spécifique.

WHENCHANGED

Facultatif. Applique une ou plusieurs règles au champ actuel lorsque la valeur d'un champ spécifique est modifiée.

WHENNOT

Facultatif. Applique une ou plusieurs règles au champ actuel lorsqu'un autre champ n'a pas de valeur spécifique.

WHENNOTCHANGED

Facultatif. Applique une ou plusieurs règles au champ actuel lorsque la valeur d'un champ spécifique n'est pas modifiée.

Éléments parents

Élément

Description

FIELDS

Obligatoire. Contient les définitions de champ du type d'élément de travail.

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.

Notes

Lorsque vous ajoutez un champ existant à un type d'élément de travail différent, les valeurs actuelles des attributs signalables sont utilisées.

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

Date

Historique

Motif

Janvier 2011

Contenu simplifié et liens supprimés vers les rubriques qui ont été supprimées.

Améliorations apportées aux informations.