Définir des conditions sur un champ d'élément de travail

Article
03/04/2013

Vous pouvez restreindre les modifications apportées à un champ en spécifiant une règle de qualification, telle que les éléments CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY et REQUIRED.Par exemple, vous pouvez utiliser la règle NOTSAMEAS pour empêcher que la même valeur soit assignée à deux champs ou que ceux-ci soient effacés en même temps.Vous pouvez également utiliser cette règle pour empêcher que le champ « vérificateur de code » se voit assigner la même valeur que celle du champ « assigné à ».

Vous pouvez spécifier ces règles comme éléments enfants des éléments FIELD (Définition), FIELD (Flux de travail) ou FIELD (Flux de travail global).Vous pouvez appliquer ou ignorer ces règles en fonction de la personne qui modifie l'élément de travail, en spécifiant un utilisateur ou un groupe pour les attributs for ou not, respectivement.

Structure de la syntaxe des éléments de règle pour les valeurs de champ

Vous pouvez spécifier la règle CANNOTLOSEVALUE pour empêcher que la valeur d'un champ soit effacée après qu'une valeur a été spécifiée.Si vous appliquez cette règle à un champ, ce champ doit toujours contenir une valeur non NULL après qu'un utilisateur a affecté une valeur au champ.
```
<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
```
Vous spécifiez la règle EMPTY pour effacer la valeur contenue dans un champ.Cette règle 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 lorsque vous enregistrez l'élément de travail, et vous ne pouvez pas spécifier de valeur.Vous utilisez principalement cette règle au cours d'une transition d'état pour effacer les champs qui s'appliquent à l'état vers lequel la transition de l'élément de travail est effectuée.
```
<EMPTY for="userGroupName"not="userGroupName" />
```
Vous spécifiez la règle FROZEN pour empêcher un utilisateur d'entrer une valeur non null dans le champ après l'enregistrement de l'élément de travail.Dès qu'un champ a une valeur définie dans la base de données, la valeur ne peut plus être modifiée.
```
<FROZEN for="userGroupName" not="userGroupName" />
```
Vous spécifiez la règle NOTSAMEAS pour empêcher qu'un champ se voit assigner la même valeur qu'un autre champ.L'attribut field doit être un nom de référence valide pour un champ.
```
<NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
```
Par exemple, l'extrait suivant empêche un champ d'avoir la même valeur que celle du champ MyCorp.Reviewer :
```
<NOTSAMEAS field="MyCorp.Reviewer" />
```
Utilisez cette règle pour les champs qui sont d'un type semblable.Vous ne pouvez pas l'utiliser pour les champs PlainText ou HTML.
Vous spécifiez la règle READONLY pour empêcher la modification de la valeur d'un champ.

N'utilisez pas cet élément avec l'élément EMPTY car EMPTY rend également un champ accessible en lecture seule.Si vous utilisez les deux éléments ensemble, cela peut donner lieu à des résultats incohérents.
```
<READONLY for="userGroupName" not="userGroupName" />
```
Vous spécifiez la règle REQUIRED pour indiquer qu'un utilisateur doit 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 défini tous les champs obligatoires.
```
<REQUIRED for="userGroupName" not="userGroupName" />
```

Retour au début

Attributs

Vous pouvez restreindre à qui s'appliquent les règles de qualification.Le tableau suivant décrit les attributs auxquels ces éléments font référence :

Attribut	Description
for	Facultatif.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle s'applique.Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères. Valeur de modèle : ^[^\\]+\\[^\\]+$ Exemple de valeur de modèle : Domaine\IDutilisateur
not	Facultatif.Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle ne s'applique pas.Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères. Valeur de modèle : ^[^\\]+\\[^\\]+$ Exemple de valeur de modèle : Domaine\IDutilisateur
field	Obligatoire pour l'élément NOTSAMEAS.Spécifie le nom de référence du champ dont la valeur n'est pas autorisée dans le champ actuel. Ce nom de référence doit correspondre à celui défini par l'élément FIELD (Définition).Pour plus d'informations, consultez Élément FIELD (Définition). Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Exemple de valeur de modèle : Company.Division.IssueType

for

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

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

Exemple de valeur de modèle : Domaine\IDutilisateur

not

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

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

Exemple de valeur de modèle : Domaine\IDutilisateur

field

Obligatoire pour l'élément NOTSAMEAS.Spécifie le nom de référence du champ dont la valeur n'est pas autorisée dans le champ actuel.

Ce nom de référence doit correspondre à celui défini par l'élément FIELD (Définition).Pour plus d'informations, consultez Élément FIELD (Définition).

Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Exemple de valeur de modèle : Company.Division.IssueType

Retour au début