Partager via


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

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.

Notes

Pour qu'un flux de travail global puisse être défini, la fonctionnalité doit être activée sur le serveur de couche Application. Par conséquent, le serveur doit exécuter une version de Visual Studio Team Foundation Server, telle que Team Foundation Server 2010 avec le Service Pack 1 (SP1), qui prend en charge cette fonctionnalité. Vous pouvez obtenir le Service Pack sur la page suivante du site Web Microsoft : Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta. Pour plus d'informations, consultez Personnalisation du workflow global.

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

Retour au début

Voir aussi

Concepts

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

Utilisation de jetons pour référencer des utilisateurs et des groupes

Autres ressources

Gestion de l'autorisation pour créer ou modifier des éléments de travail

Utilisation de règles de champs

Définition des champs d'éléments de travail

Historique des modifications

Date

Historique

Motif

Janvier 2011

Le contenu a été révisé pour être simplifié et pour fournir la structure de la syntaxe de chaque élément de règle.

Améliorations apportées aux informations.