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" />
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. |