Règles des champs disponibles

Mise à jour : novembre 2007

Les règles des champs définissent le comportement et les contraintes sur les champs. Elles constituent des éléments supplémentaires répertoriés dans les blocs <FIELD></FIELD>. Par exemple, si un champ est obligatoire, l'élément XML qui définit le champ peut se présenter comme suit :

<FIELD refname="System.Priority" name="Priority" type="String">
<HELPTTEXT>Enter the business priority of the bug</HELPTEXT>
<REQUIRED />
</FIELD>

Règles des champs disponibles

Vous pouvez utiliser les règles des champs suivants pour modifier le comportement d'un champ :

<REQUIRED />

Ce champ ne peut pas être vide. Vous pouvez marquer n'importe quel type de champ comme obligatoire. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez REQUIRED, élément (Schéma de définition du type d'élément de travail).

<READONLY />

Le champ ne peut pas être modifié. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez READONLY, élément (Schéma de définition du type d'élément de travail).

<EMPTY />

La valeur de champ est effacée lors de la validation et l'utilisateur ne peut entrer aucune 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 est effectuée. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez EMPTY, élément (Schéma de définition du type d'élément de travail).

<FROZEN/>

Dès qu'un champ a une valeur après une validation, la valeur ne peut plus être modifiée. Toutefois, le champ peut être effacé à l'aide d'une contrainte <EMPTY/>. L'utilisateur peut effacer le champ manuellement, enregistrer l'élément de travail, puis spécifier une valeur différente lors du rechargement. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez FROZEN, élément (Schéma de définition du type d'élément de travail).

<CANNOTLOSEVALUE/>

Une fois qu'un champ a acquis une valeur, il ne peut pas être effacé ou vidé. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez CANNOTLOSEVALUE, élément (Schéma de définition du type d'élément de travail).

<NOTSAMEAS field="MyCorp.Reviewer" />

La valeur du champ ne peut pas être la même que celle d'un autre champ, en l'occurrence le champ "MyCorp.Reviewer." La valeur du champ doit être un nom de référence de champ valide. Pour plus d'informations, consultez Noms de références des champs.

Exemples d'utilisation de la règle de champ NOTSAMEAS :

• Deux champs ne peuvent pas être vides en même temps.

• La valeur de champ "vérificateur de code" ne peut pas correspondre exactement à la valeur de champ "assigné à".

Utilisez cette règle pour les champs de ce type. Vous ne pouvez pas l'utiliser pour les champs PlainText ou HTML. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez NOTSAMEAS, élément (Schéma de définition du type d'élément de travail).

<VALIDUSER group="group" />

La valeur du champ doit être un utilisateur valide qui est membre du groupe Team Foundation Valid Users.

Cette règle prend en charge l'attribut group facultatif pour spécifier que l'utilisateur doit être un membre direct ou indirect du groupe spécifié. Par défaut, la règle autorise tous les utilisateurs qui sont membres du groupe Team Foundation Valid Users. Pour plus d'informations, consultez Utilisation de jetons pour référencer des utilisateurs et des groupes. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez VALIDUSER, élément (Schéma de définition du type d'élément de travail).

Remarque :
Si la règle <REQUIRED/> n'est pas spécifiée, ce champ acceptera une valeur vide. Utilisée pour les types de champs Chaîne.

Remarque :

Les champs d'éléments de travail ne distinguent pas les identités utilisateur dans les différents domaines. Par conséquent, "Example1\jaepak" et "Example2\jaepak" sont considérés comme étant le même utilisateur lorsqu'ils sont entrés dans un champ qui utilise la règle <VALIDUSER />. Par contre, dans un autre emplacement de Team Foundation Server, ces identités utilisateur sont distinguées par domaine.

<ALLOWEXISTINGVALUE/>

Permet à un champ de conserver une valeur existante, même si cette valeur n'est plus activée. Le comportement par défaut consiste à forcer l'utilisateur, au moment de la modification, à utiliser les dernières valeurs activées pour ce champ. Cet élément a uniquement un effet modifiant sur les éléments du même bloc. Cet élément ne peut pas accepter des attributs for ou not. Pour plus d'informations, consultez ALLOWEXISTINGVALUE, élément (Schéma de définition du type d'élément de travail).

<ALLOWEDVALUES/>

Liste énumérée des valeurs présentées à l'utilisateur sous forme de liste. Les utilisateurs doivent sélectionner l'une des valeurs dans cette liste. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez ALLOWEDVALUES, élément (Schéma de définition du type d'élément de travail).

<SUGGESTEDVALUES/>

Liste énumérée des valeurs présentées à l'utilisateur sous forme de liste. Les utilisateurs peuvent sélectionner n'importe laquelle de ces valeurs. Les utilisateurs peuvent également entrer leur propre valeur qui ne fait pas partie des suggestions. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez SUGGESTEDVALUES, élément (Schéma de définition du type d'élément de travail).

<PROHIBITEDVALUES/>

Les utilisateurs ne peuvent pas enregistrer d'élément de travail si le champ contient des valeurs interdites. Les valeurs interdites sont généralement utilisées lorsqu'une valeur a été précédemment autorisée et qu'elle n'est plus valide. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez PROHIBITEDVALUES, élément (Schéma de définition du type d'élément de travail).

<DEFAULT>

Lorsqu'un utilisateur crée un élément de travail ou en modifie un, l'élément <DEFAULT> remplit une valeur de champ si ce champ est vide. Si un champ a déjà une valeur, la règle par défaut est ignorée. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez DEFAULT, élément (Schéma de définition du type d'élément de travail).

Remarque :
Lors de la modification d'un élément de travail, cette règle d'élément est non déterministe lorsqu'il s'agit de sélectionner la valeur actuelle ou précédente d'un autre champ.

<COPY>

Lorsqu'un utilisateur crée un élément de travail ou en modifie un, l'élément <COPY> remplit une valeur de champ, quelle que soit la valeur qui existe déjà dans le champ. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez COPY, élément (Schéma de définition du type d'élément de travail).

Remarque :
Lors de la modification d'un élément de travail, cette règle d'élément est non déterministe lorsqu'il s'agit de sélectionner la valeur actuelle ou précédente d'un autre champ.

<SERVERDEFAULT>

Contrairement aux éléments <DEFAULT> et <COPY> qui remplissent des valeurs au début de la modification, la règle <SERVERDEFAULT> remplit une valeur lorsque l'élément de travail est validé pour la base de données. Cette action se produit au moment de la sauvegarde et l'utilisateur ne peut pas substituer la valeur. Ces champs apparaissent en lecture seule sur le formulaire. Cette règle est utilisée pour les champs tels que "Dernière modification par" et "Dernière modification le" pour prendre en charge les traces d'audit sécurisées. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez SERVERDEFAULT, élément (Schéma de définition du type d'élément de travail).

<MATCH pattern="<pattern>"/>

Applique les critères spéciaux de base uniquement pour les chaînes. <pattern> doit être remplacé par le modèle de correspondance. Les valeurs valides sont "A", "N", "X." Toutes les autres valeurs sont considérées comme des littéraux. "A" représente un caractère alphabétique. "N" représente un caractère numérique. "X" représente n'importe quel caractère alphanumérique. Ce modèle n'est pris en charge que pour les champs de type Chaîne. Cet élément accepte les attributs for et not. Pour plus d'informations, consultez MATCH, élément (Schéma de définition du type d'élément de travail).

Exemples de critères spéciaux

Les exemples suivants illustrent les modèles de correspondance réussis et non réussis pour plusieurs utilisations des champs :

Numéro de version

Modèle : ANN.NN.NN

Identificateur souple

Modèle : XXX-XXX

Priorité

Modèle : PN

Les balises de correspondance ne respectent pas la casse ; ainsi, "PN" correspond à la fois à P1 et à p1.

Remarque :
Vous pouvez spécifier plusieurs éléments <MATCH>. Si au moins un élément réussit, le champ a une valeur valide.

Voir aussi

Autres ressources

Définition de listes de champs