Partager via

Référence de tous les éléments XML FIELD

  • Article

Vous pouvez utiliser les informations de cette rubrique comme une référence rapide à tous les éléments et aux principaux attributs qui définissent un champ de données pour un type d'élément de travail.Vous spécifiez ces éléments dans le conteneur d'éléments FIELD (Définition).Vous ajoutez un champ pour un type d'élément de travail en spécifiant un élément FIELD (Définition) dans l'élément FIELDS (Définition).Vous pouvez spécifier ces éléments dans la définition d'un type d'élément de travail ou dans un flux de travail global.Vous pouvez créer les éléments enfants décrits dans cette rubrique pour spécifier le comportement d'un champ, définir les valeurs par défaut ou définir une liste de choix de valeurs.Vous pouvez combiner des éléments de règle de champ.Vous pouvez délimiter la plupart des règles de sorte qu'elles s'appliquent à un ou plusieurs utilisateurs ou qu'elles soient ignorées pour un ou plusieurs utilisateurs ou groupes.

Tous les éléments enfants de l'élément FIELD sont facultatifs.À l'exception de l'élément d' HELPTEXT, vous pouvez spécifier tous les éléments comme éléments enfants des éléments d' FIELD (définition), d' FIELD (flux de travail), et d' FIELD (flux de travail global).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.Spécifiez des règles pour un élément FIELD (Flux de travail) afin de définir la valeur d'un champ ou d'appliquer des règles à celui-ci comme des transitions d'élément de travail d'un état à un autre.Vous pouvez spécifier des règles de champ basées sur l'élément STATE, TRANSITION, DEFAULTREASON ou REASON dont l'élément FIELDS parent est un enfant.Pour plus d'informations, consultez Utilisation des champs d'élément de travail et Concevoir le flux de travail.

Dans cette rubrique

  • Élément conteneur FIELD (Définition)

  • Éléments enfants FIELD

  • Éléments enfants GLOBALLIST et LISTITEM

  • Attributs spécifiés par les éléments enfants FIELD

Élément conteneur FIELD (Définition)

Vous utilisez la syntaxe suivante afin de définir les champs de données pour un type d'élément de travail.Cet exemple illustre le format de l'élément FIELD (Définition) et tous les éléments enfants facultatifs.Pour plus d'informations, consultez Élément FIELD (Définition).

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <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>

Éléments enfants FIELD

Le tableau suivant décrit les éléments enfants que vous pouvez spécifier afin d'appliquer des règles pour l'assignation d'une valeur à un champ.Tous les éléments enfants sont facultatifs.Vous pouvez délimiter la plupart des éléments enfants de sorte qu'ils s'appliquent à un groupe unique ou à toute personne, à l'exception des utilisateurs dans un groupe unique.

Élément

Description et syntaxe

ALLOWEDVALUES

Définit une liste de valeurs que les utilisateurs peuvent spécifier dans une liste de champs sur des formulaires d'élément de travail et dans l'éditeur de requêtes.Les utilisateurs doivent spécifier l'une des valeurs que vous répertoriez.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Pour plus d'informations, consultez Définir des listes de choix.

ALLOWEXISTINGVALUE

Spécifie qu'un champ peut conserver une valeur existante, même si elle n'apparaît plus dans une liste de choix.Toutes les nouvelles valeurs de champ doivent figurer dans la liste.

<ALLOWEXISTINGVALUE />

Pour plus d'informations, consultez Définir des listes de choix.

CANNOTLOSEVALUE

Spécifie que les utilisateurs ne peuvent pas effacer la valeur d'un champ et le laisser vide une fois qu'une valeur a été spécifiée.Une fois qu'un champ a contenu une valeur, il doit toujours contenir une valeur non null.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

COPY

Copie une valeur spécifiée dans un champ lorsqu'un utilisateur crée ou modifie un élément de travail.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Pour plus d'informations, consultez Définir une valeur par défaut ou copier une valeur dans un champ.

DEFAULT

Spécifie une valeur pour un champ qui est vide lorsqu'un utilisateur crée ou modifie un élément de travail.Si un champ a déjà une valeur, la règle par défaut est ignorée.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Pour plus d'informations, consultez Définir une valeur par défaut ou copier une valeur dans un champ.

EMPTY

Efface la valeur du champ.La règle EMPTY rend également un champ accessible en lecture seule, et vous ne devez pas l'utiliser avec la règle READONLY.

La valeur de champ est effacée lorsqu'un utilisateur enregistre l'élément de travail, et vous ne pouvez pas spécifier de valeur.Cette règle est principalement utilisée au cours d'une transition d'état pour effacer les champs qui s'appliquent à l'état vers lequel la transition de l'élément est effectuée.

<EMPTY for="userGroupName" not=" userGroupName" />

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

FROZEN

Spécifie que vous ne pouvez pas affecter au champ une valeur non vide une fois les modifications validées.Dès qu'un utilisateur enregistre l'élément de travail avec une valeur dans ce champ, la valeur ne peut plus être modifiée.

<FROZEN for="userGroupName" not="userGroupName" />

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

HELPTEXT

Définit le texte à afficher lorsqu'un utilisateur pointe sur le champ dans le formulaire d'élément de travail.

TexteInfobulle : chaîne de texte qui contient entre 1 et 255 caractères.

<HELPTEXT>tooltipText </HELPTEXT>

Pour plus d'informations, consultez Définir le texte d'aide d'un champ d'élément de travail.

MATCH

Définit un modèle auquel les valeurs des champs de type String doivent correspondre.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Pour plus d'informations, consultez Mettre en correspondance un champ de type chaîne à un modèle.

NOTSAMEAS

Spécifie qu'un champ n'est pas assigné la même valeur que celui auquel un autre champ spécifié est assigné.La valeur de l'attribut field doit être un nom de référence de champ valide.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

PROHIBITEDVALUES

Définit la liste des valeurs qu'un champ ne peut pas contenir.Les utilisateurs ne peuvent pas enregistrer un élément de travail si le champ contient une valeur interdite.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Pour plus d'informations, consultez Définir des listes de choix.

READONLY

Spécifie que vous ne pouvez pas modifier la valeur assignée au champ.

<READONLY for="userGroupName" not="userGroupName" />
RemarqueRemarque
N'utilisez pas cet élément avec l'élément EMPTY car EMPTY rend également un champ accessible en lecture seule.Si vous combinez ces éléments, les résultats seront incohérents.

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

REQUIRED

Spécifie que les utilisateurs doivent spécifier une valeur pour le champ.Les champs obligatoires ne peuvent pas être vides.Les utilisateurs ne peuvent pas enregistrer un élément de travail tant qu'ils n'ont pas assigné des valeurs à tous les champs obligatoires.

<REQUIRED for="userGroupName" not="userGroupName" />

Pour plus d'informations, consultez Définir des conditions sur un champ d'élément de travail.

SERVERDEFAULT

Copie une valeur de serveur spécifiée vers un champ lorsqu'un utilisateur enregistre un élément de travail.Ces champs apparaissent généralement en lecture seule sur le formulaire.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Pour plus d'informations, consultez Définir une valeur par défaut ou copier une valeur dans un champ.

SUGGESTEDVALUES

Définit une liste de valeurs suggérées que les utilisateurs peuvent spécifier dans une liste de champs sur des formulaires d'élément de travail et dans l'éditeur de requêtes.Les utilisateurs peuvent spécifier d'autres valeurs que celles que vous suggérez.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Pour plus d'informations, consultez Définir des listes de choix.

VALIDUSER

Spécifie que les éléments de travail ne peuvent être modifiés que par les utilisateurs appartenant au groupe que vous indiquez.Le groupe par défaut est le groupe Team Foundation Valid Users.

Tous les attributs sont facultatifs.Tous les attributs doivent être constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.Vous pouvez utiliser des jetons pour spécifier des groupes.Pour plus d'informations, consultez Utiliser des jetons pour référencer des utilisateurs et des groupes.

< VALIDUSER group="groupName" for="userName" not="userName" />

Pour plus d'informations, consultez Gérer l'autorisation pour créer ou modifier des éléments de travail.

WHEN

Spécifie une ou plusieurs règles à appliquer au champ actuel lorsqu'un autre champ a une valeur spécifique.L'élément parent FIELD définit le champ actuel.

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

Pour plus d'informations, consultez Assigner des valeurs et des règles conditionnelles.

WHENNOT

Spécifie une ou plusieurs règles à appliquer au champ actuel lorsqu'un autre champ n'a pas de valeur spécifique.L'élément parent FIELD définit le champ actuel.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Pour plus d'informations, consultez Assigner des valeurs et des règles conditionnelles.

WHENCHANGED

Spécifie une ou plusieurs règles à appliquer au champ actuel lorsque la valeur d'un autre champ est modifiée au cours de la révision de l'élément de travail.L'élément parent FIELD définit le champ actuel.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Pour plus d'informations, consultez Assigner des valeurs et des règles conditionnelles.

WHENNOTCHANGED

Spécifie une ou plusieurs règles à appliquer au champ actuel lorsque la valeur d'un autre champ n'est pas modifiée au cours de la révision de l'élément de travail.L'élément parent définit le champ actuel.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Pour plus d'informations, consultez Assigner des valeurs et des règles conditionnelles.

Éléments enfants GLOBALLIST et LISTITEM

Le tableau suivant décrit les éléments GLOBALLIST et LISTITEM.Vous spécifiez ces éléments en tant qu'éléments enfants des éléments ALLOWEDVALUES, SUGGESTEDVALUES et PROHIBITEDVALUES.Vous pouvez utiliser ces éléments pour énumérer une liste de valeurs présentée à l'utilisateur comme une liste de choix ou un menu déroulant d'éléments.Pour plus d'informations, consultez Définir des listes utilisateur, des listes de choix et des listes globales.

Élément

Syntaxe

Description

GLOBALIST

 
<GLOBALLIST name="globalListName
">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Définit un ensemble d'éléments LISTITEM stocké pour une collection de projets d'équipe et pouvant être utilisé par tous les projets d'équipe dans une collection.

NomListeGlobale : chaîne de texte qui contient entre 1 et 255 caractères.

GLOBALLIST est un élément enfant obligatoire de l'élément GLOBALLISTS et un élément enfant facultatif des éléments ALLOWEDVALUES, SUGGESTEDVALUES et PROHIBITEDVALUES.Vous pouvez définir une liste globale dans une définition d'élément de travail, une définition de liste globale ou un flux de travail global.

LISTITEM

 
<LISTITEM value="listName" />

Définit une valeur de liste valide.

LISTITEM est un élément enfant obligatoire de l'élément GLOBALLIST et un élément enfant facultatif des éléments ALLOWEDVALUES, SUGGESTEDVALUES et PROHIBITEDVALUES.

Retour au début

Attributs spécifiés par les éléments enfants FIELD

Vous pouvez qualifier la plupart des règles FIELD pour qu'elles s'appliquent ou non à un ensemble de groupes ou d'utilisateurs en incluant les attributs for ou not.Pour plus d'informations, consultez Limiter à un groupe la portée d'une règle de champ.

Attribut

Syntaxe

Description

expanditems

expanditems="true | false"

Optionnel.Indique si un groupe que l'élément d' LISTITEM identifie doit être développé pour inclure des groupes subordonnés dans la liste.La valeur par défaut de cet attribut est true.

filteritems

filteritems="excludegroups"

Optionnel.Spécifie que seuls les membres des groupes et non les noms de groupes, sont inclus dans la liste.La seule valeur d'attribut autorisée pour cet attribut est excludegroups.

for

for="userGroupName"

Optionnel.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle s'applique.Les valeurs valides sont constituées d'une chaîne de texte qui contient entre 1 et 255 caractères.

not

not="userGroupName"

Optionnel.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle ne s'applique pas.Les valeurs valides sont constituées d'une chaîne de texte qui contient entre 1 et 255 caractères.

from

from="value | field | clock | currentuser"

Requis.Spécifie la source de la valeur à partir de laquelle vous voulez copier une valeur ou indiquer une valeur par défaut.Les valeurs suivantes sont valides :

  • clock: Copie la date et l'heure actuelles de l'horloge système aux champs datetime. Aucun attribut supplémentaire n'est requis.Pour les règles COPY et DEFAULT, cette valeur est prise à partir de l'horloge de l'ordinateur local.Pour SERVERDEFAULT, la valeur provient de l'horloge serveur lorsqu'un utilisateur enregistre l'élément de travail.

  • currentuser: Copie le nom de l'utilisateur actuellement connecté.Utilisez le nom court de l'utilisateur actuel comme valeur.Aucun attribut supplémentaire n'est requis.Utilisé pour les champs de chaîne.

  • field : Copie la valeur de l'attribut field que vous spécifiez.Requiert un attribut field="abc".Par défaut, si le champ spécifié « de » est vide, rien n'est exécuté.L'attribut field n'est utilisé que pour les règles <COPY> et <DEFAULT>.

  • value : Copie la valeur de l'attribut value que vous spécifiez.Utilisez la valeur d'une constante de chaîne que vous spécifiez.Requiert un attribut value="abc".value est utilisé uniquement pour les règles <COPY> et <DEFAULT>.

Si vous spécifiez « value » ou « field », vous devez également inclure l'attribut value ou field, respectivement.

field

field="fieldReferenceName"

Optionnel.Spécifie le nom du champ dont la valeur sera copiée lorsque field est spécifié pour l'attribut from.

pattern

pattern= "patternValue »

Requis.Applique les critères spéciaux de base uniquement pour les chaînes.patternValue est une chaîne qui se compose entre 1 et 255 caractères, incorporée.Cette chaîne ne doit pas contenir une barre oblique inverse (\).Chaque caractère de la chaîne est interprète comme un littéral, à moins qu'il soit l'un des six métacaractères suivants :

  • « A » ou « a » représentent une lettre unique.

  • « N » ou « n » représentent un chiffre unique.

  • « X » ou « x » représente un caractère alphanumérique unique.

Valeur de modèle : ^[^\\]*$

Par exemple, pattern="xxxxx.nn.nn" correspond à cinq caractères alphanumériques quelconques, puis un point, puis deux chiffres, puis un point, puis deux chiffres supplémentaires.

value

value="valueToCopy"

Optionnel.Spécifie la valeur à copier dans le champ lorsque la valeur value est spécifiée pour l'attribut from.

Retour au début

Voir aussi

Concepts

Définir des listes utilisateur, des listes de choix et des listes globales

Utilisation des champs d'élément de travail

Concevoir le flux de travail