Appliquer des critères spéciaux à un champ de chaîne
Vous pouvez utiliser l'élément MATCH pour forcer les valeurs d'un champ de type String à suivre un modèle que vous spécifiez. Si vous définissez plusieurs éléments MATCH, la valeur sera valide si elle correspond à un des modèles que vous spécifiez pour le champ. Si au moins un élément réussit, le champ a une valeur valide.
Notes
Pour ajouter une règle à une définition FIELD, utilisez l'outil en ligne de commande witadmin pour importer et exporter la définition du type d'élément de travail.Voir Importer, exporter et gérer des types d'éléments de travail [witadmin].
Structure de la syntaxe de l'élément MATCH
L'élément MATCH vous permet d'appliquer la mise en correspondance de modèle de base en définissant un modèle auquel les valeurs dans les champs de type chaîne doivent correspondre.
<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />
Attributs
Vous pouvez spécifier les utilisateurs auxquels la règle MATCH s'applique. Si vous ne définissez pas d'attributs facultatifs, tous les utilisateurs et groupes valides dans Team Foundation Server doivent spécifier une valeur qui correspond au modèle.
Attribut |
Description |
|---|---|
pattern |
Requis. Applique la mise en correspondance du modèle de base uniquement pour les chaînes, et uniquement pour les chaînes pour lesquelles syncnamechanges="false". Les valeurs valides pour patternValue sont « A », « N » et « X », qui indiquent les types de caractères suivants :
Toutes les autres valeurs sont considérées comme des littéraux. Longueur minimale : 1 ; longueur maximale : 255. Valeur de modèle : ^[^\\]*$ Exemple de valeur de modèle : xxxxx. nn. nn |
for |
Facultatif. Indique 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. Indique 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 |
Retour au début
Exemples de critères spéciaux
Les exemples suivants illustrent la réussite et l'échec de correspondances de modèle pour diverses utilisations de champ.
Numéro de version
Modèle : ANN.NN.NN
Valide |
R01.03.04 ou V05.08.99 |
Échec de la validation |
1.3.4 ou V5.8.99 ou v1.3 |
Identificateur flexible
Modèle : XXX-XXX
Valide |
001-abc ou a00-b02 |
Échec de la validation |
1-abc ou 001.abc |
Priorité
Modèle : PN
Valide |
P1, P5 ou P9 |
Échec de la validation |
1 ou P10 |
Les balises de correspondance ne respectent pas la casse. Ainsi, « PN » correspond à la fois à P1 et p1.
Retour au début