Mettre en correspondance un champ de type chaîne à un modèle

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 à l'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.

[!REMARQUE]

Pour ajouter une règle à une définition d' FIELD, utilisez l'outil en ligne de commande des witadmin pour importer et exporter la définition du type d'élément de travail.Consultez Personnaliser et gérer des types d'éléments de travail (witadmin).

Structure de la syntaxe de l'élément MATCH

Vous utilisez l'élément MATCH pour appliquer des critères spéciaux de base en définissant un modèle auquel les valeurs des champs de type String doivent correspondre.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Attributs

Vous pouvez spécifier les utilisateurs auxquels s'applique la règle MATCH.Si vous ne définissez pas d'attribut facultatif, tous les groupes et les utilisateurs valides dans Team Foundation Server doivent spécifier une valeur qui correspond au modèle.

Attribut	Description
pattern	Requis.Applique les critères spéciaux de base uniquement pour les chaînes.Les valeurs valides pour ValeurModèle sont « A », « N » et « X », qui identifient les types de caractères suivants : « 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. 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	Optionnel.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	Optionnel.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

Retour au début

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

Valides	R01.03.04 ou V05.08.99
Échec de la validation	1.3.4, V5.8.99 ou v1.3

Identificateur souple

Modèle : XXX-XXX

Valides	001-abc ou a00-b02
Échec de la validation	1-abc ou 001.abc

Priorité

Modèle : PN

Valides	P1, P5 ou P9
Échec de la validation	1 ou P10

Les balises de correspondance ne respectent pas la casse.Par conséquent, « PN » correspond à la fois à P1 et à p1.

Retour au début

Voir aussi

Autres ressources

Utilisation de règles de champs