Référence des éléments 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 son type de données et s'il peut être inclus dans les rapports
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).
Hiérarchie de schéma
FIELD
<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 |
Requis. 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 de l'étiquette qui s'affiche à 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 |
Requis. Nom unique qui fait la distinction entre un champ et tous les autres champs qui sont définis dans la collection de projets d'équipe. Pour obtenir 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 |
Requis. Spécifie le type de données que le champ accepte. Notes Des champs de différentes collections de projets ayant la même valeur reportingrefname doivent avoir 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ésoudre les 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 :
|
||||||||||||||||||||
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 dans 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. Spécifie si les données du champ sont disponibles pour être incluses dans les rapports. 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 Ajouter et modifier des champs d'éléments de travail pour prendre en charge la création de rapports. Notes Des champs dans différentes collections de projets ayant la même valeur reportingrefname doivent avoir 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ésoudre les 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 :
|
||||||||||||||||||||
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 rapports. Si vous ne spécifiez pas de valeur, la valeur assignée à l'attribut name est utilisée. Notes Des champs de différentes collections de projets ayant la même valeur reportingrefname doivent avoir 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ésoudre les 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 ayant des noms de référence distincts et étant définis dans des collections de projets différentes, vous assignez le même attribut reportingrefname aux deux. 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 |
|---|---|
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. |
|
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. |
|
Facultatif. Définit le champ comme ne pouvant pas perdre sa valeur. Cet élément garde la valeur de champ actuelle et ne peut pas être effacé ni vidé. |
|
Facultatif. Spécifie un autre champ qui contient une valeur à copier dans le champ actuel. |
|
Facultatif. Définit une valeur par défaut pour le champ. |
|
Facultatif. Définit le champ comme étant vide. |
|
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. |
|
Facultatif. Définit le texte affiché dans l'info-bulle pour le champ. |
|
Facultatif. Définit un modèle pour le champ auquel la valeur du champ doit correspondre. |
|
Facultatif. Spécifie un autre champ dont la valeur ne peut pas être identique à la valeur du champ actuel. |
|
Facultatif. Définit une liste de valeurs interdites pour le champ. |
|
Facultatif. Définit le champ comme étant en lecture seule. |
|
Facultatif. Définit le champ comme obligatoire. |
|
Facultatif. Spécifie un composant serveur qui fournit la valeur du champ. |
|
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. |
|
Facultatif. Indique que la liste de valeurs autorisées ne doit comporter que des utilisateurs valides du système. |
|
Facultatif. Spécifie une ou plusieurs règles à appliquer au champ actuel lorsqu'un autre champ a une valeur spécifique. |
|
Facultatif. Applique une ou plusieurs règles au champ actuel lorsque la valeur d'un champ spécifique est modifiée. |
|
Facultatif. Applique une ou plusieurs règles au champ actuel lorsqu'un autre champ n'a pas de valeur spécifique. |
|
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 |
|---|---|
Requis. 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).
Pour obtenir une vue d'ensemble de tous les champs système et des champs prédéfinis qui sont définis pour les modèles de processus TFS, consultez Référence des champs d'éléments de travail pour Visual Studio ALM.
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 obtenir 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.
Même si vous pouvez modifier le nom convivial d'un champ, vous ne pouvez pas modifier les noms de référence de champ. Vous pouvez répertorier des champs et modifier plusieurs attributs de champ à l'aide de l'outil en ligne de commande witadmin. Consultez Gérer des champs d'éléments de travail (witadmin).
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.
Tous les champs définis dans tous les types d'éléments de travail de tous les projets d'équipe définis pour une collection de projets sont destinés à 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.
Pour plus d'informations sur le mode d'étiquetage des champs à des fins de requête, consultez Ajouter et modifier des champs d'éléments de travail pour prendre en charge la création de rapports.
Lorsque vous ajoutez un champ existant à un type d'élément de travail différent, définissez explicitement les attributs de rapports pour qu'ils soient identiques à la définition de champ actuelle ou laissez ces valeurs par défaut.
Des conflits de schéma peuvent se produire si des attributs de rapports différents sont assignés au même champ dans des types d'éléments de travail différents ou dans les mêmes types d'éléments de travail de plusieurs projets d'équipe. Pour résoudre ces conflits, consultez Résoudre les conflits de schéma qui se produisent dans l'entrepôt de données.
Pour comprendre comment les champs permettent de prendre en charge des requêtes, des rapports et le suivi des éléments de travail, consultez Modifier ou ajouter un champ pour prendre en charge les requêtes, les rapports et le flux de travail.
Pour obtenir une vue d'ensemble de l'application de contraintes ou de conditions à un élément FIELD à l'aide d'éléments enfants, consultez Appliquer une règle à un champ d'élément de travail.
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
Gérer des champs d'éléments de travail (witadmin)
Concepts
Conventions d'affectation de noms pour les objets de suivi des éléments de travail
Référence des champs d'éléments de travail pour Visual Studio ALM
Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe
Définir et modifier les champs des éléments de travail
Autres ressources
Suivi des éléments de travail : index des définitions d'éléments XML