Partager via


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 :

  • « A » représente un caractère alphabétique.

  • « N » représente un caractère numérique.

  • « X » représente un 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. 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

Voir aussi

Autres ressources

Appliquer une règle à un champ d'élément de travail