Mise en correspondance d'un champ de type chaîne à un modèle

Article
08/10/2011

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.

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	Obligatoire. 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	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

pattern

Obligatoire. 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

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

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

Historique des modifications

Date	Historique	Motif
Janvier 2011	La syntaxe de l'élément MATCH a été ajoutée.	Améliorations apportées aux informations.

Janvier 2011

La syntaxe de l'élément MATCH a été ajoutée.

Améliorations apportées aux informations.

Partager via