Aplicar la coincidencia de patrones a un campo de cadena

Artículo
11/18/2015

Puede usar el elemento MATCH para forzar que los valores de un campo de tipo de cadena sigan un patrón que especifique. Si define varios elementos MATCH, el valor será válido si coincide con cualquiera de los patrones que se especifican para el campo. Si al menos un elemento es correcto, el valor del campo será válido.

Nota

Para agregar una regla para una definición FIELD, use la herramienta de línea de comandos witadmin para importar y exportar la definición para el tipo de elemento de trabajo.Consulte Importar, exportar y administrar tipos de elementos de trabajo [witadmin].

Estructura de sintaxis de elemento MATCH

Use el elemento MATCH para exigir el patrón básico que coincide mediante la definición de un patrón cuyos valores de los campos de tipo de cadena deben coincidir.

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

Atributos

Puede especificar a qué usuarios se aplica la regla MATCH. Si no se definen atributos opcionales, todos los usuarios y grupos válidos en Team Foundation Server deben especificar un valor que coincida con el patrón.

Atributo	Descripción
pattern	Requerido. Exige que el patrón básico coincida solo para cadenas y solo para cadenas con syncnamechanges="false". Los valores válidos para patternValue son "A", "N" y "X", que indican los tipos de caracteres siguientes: "A" representa un carácter alfabético. "N" representa un carácter numérico. "X" representa cualquier carácter alfanumérico. Todos los demás valores toman como contenido literal. Longitud mínima: 1; longitud máxima: 255. Valor de patrón: ^[^\\]*$ Ejemplo de un valor de patrón: xxxxx. nn. nn
for	Opcional. Especifica el nombre de un usuario o grupo en Team Foundation al que se le aplica la regla. Los nombres válidos constan de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de patrón: ^[^\\]+\\[^\\]+$ Ejemplo de valor de patrón: Domain\UserID
not	Opcional. Especifica el nombre de un usuario o grupo en Team Foundation al que no se le aplica la regla. Los nombres válidos constan de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de patrón: ^[^\\]+\\[^\\]+$ Ejemplo de valor de patrón: Domain\UserID

pattern

Requerido. Exige que el patrón básico coincida solo para cadenas y solo para cadenas con syncnamechanges="false".

Los valores válidos para patternValue son "A", "N" y "X", que indican los tipos de caracteres siguientes:

"A" representa un carácter alfabético.
"N" representa un carácter numérico.
"X" representa cualquier carácter alfanumérico.

Todos los demás valores toman como contenido literal. Longitud mínima: 1; longitud máxima: 255.

Valor de patrón: ^[^\\]*$

Ejemplo de un valor de patrón: xxxxx. nn. nn

for

Opcional. Especifica el nombre de un usuario o grupo en Team Foundation al que se le aplica la regla. Los nombres válidos constan de una cadena de texto que contiene entre 1 y 255 caracteres.

Valor de patrón: ^[^\\]+\\[^\\]+$

Ejemplo de valor de patrón: Domain\UserID

not

Opcional. Especifica el nombre de un usuario o grupo en Team Foundation al que no se le aplica la regla. Los nombres válidos constan de una cadena de texto que contiene entre 1 y 255 caracteres.

Valor de patrón: ^[^\\]+\\[^\\]+$

Ejemplo de valor de patrón: Domain\UserID

Volver al principio

Ejemplos de coincidencias de patrones

En los ejemplos siguientes se muestran coincidencias de patrones correctas e incorrectas para varios usos de los campos.

Número de versión

Patrón: ANN.NN.NN

Valida	R01.03.04 o V05.08.99
Error de validación	1.3.4 o V5.8.99 o v1.3

Identificador flexible

Patrón: XXX-XXX

Valida	001 abc o a00-b02
Error de validación	1-abc o 001.abc

Prioridad

Patrón: PN

Valida	P1 o P5 o P9
Error de validación	1 o P10

Las etiquetas de coincidencia no distinguen mayúsculas de minúsculas. Por lo tanto, "PN" coincide con P1 y con p1.