Обеспечение соответствия строкового поля шаблону

Статья
02/20/2013

Элемент MATCH позволяет принудительно обеспечить соответствие значения в поле строкового типа заданному шаблону.Если определить несколько элементов MATCH, значение будет допустимым, если оно соответствует любому из определенных для поля шаблонов.Если есть хотя бы одно успешное соответствие, тип поля считается допустимым.

Примечание
Чтобы добавить правило в определение FIELD, можно использовать программу командной строки witadmin, чтобы импортировать и экспортировать определение типа рабочего элемента.Дополнительные сведения см. в разделе Настройка типов рабочих элементов и управление ими [witadmin].

Чтобы добавить правило в определение FIELD, можно использовать программу командной строки witadmin, чтобы импортировать и экспортировать определение типа рабочего элемента.Дополнительные сведения см. в разделе Настройка типов рабочих элементов и управление ими [witadmin].

Структура синтаксиса элемента MATCH

Элемент MATCH принудительно обеспечивает соответствие базовому шаблону; для этого необходимо определить шаблон, которому должны соответствовать значения в полях строкового типа.

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

Атрибуты

Можно указать пользователей, на которых распространяется действие правила MATCH.Если ни один необязательный атрибут не определен, все допустимые пользователи и группы Team Foundation Server должны указывать значение, соответствующее шаблону.

Атрибут	Описание
pattern	Обязательное.Следит за соответствием строк основным шаблонам.Допустимыми значениями атрибута patternValue являются "A", "N" и "X", которые обозначают следующие типы знаков: "A" соответствует алфавитному символу; "N" соответствует цифре; "X" соответствует любому алфавитно-цифровому символу. Все остальные считаются обычными буквами.Минимальная длина: 1; максимальная длина: 255. Значение шаблона: ^[^\\]*$ Пример значения шаблона: xxxxx.nn.nn
for	Необязательный параметр.Задает имя пользователя или группы Team Foundation, к которым применяется данное правило.Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков. Значение шаблона: ^[^\\]+\\[^\\]+$ Пример значения шаблона: Domain\userID
not	Необязательный параметр.Задает имя пользователя или группы Team Foundation, к которым данное правило не применяется.Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков. Значение шаблона: ^[^\\]+\\[^\\]+$ Пример значения шаблона: Domain\userID

pattern

Обязательное.Следит за соответствием строк основным шаблонам.Допустимыми значениями атрибута patternValue являются "A", "N" и "X", которые обозначают следующие типы знаков:

"A" соответствует алфавитному символу;
"N" соответствует цифре;
"X" соответствует любому алфавитно-цифровому символу.

Все остальные считаются обычными буквами.Минимальная длина: 1; максимальная длина: 255.

Значение шаблона: ^[^\\]*$

Пример значения шаблона: xxxxx.nn.nn

for

Необязательный параметр.Задает имя пользователя или группы Team Foundation, к которым применяется данное правило.Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков.

Значение шаблона: ^[^\\]+\\[^\\]+$

Пример значения шаблона: Domain\userID

not

Необязательный параметр.Задает имя пользователя или группы Team Foundation, к которым данное правило не применяется.Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков.

Значение шаблона: ^[^\\]+\\[^\\]+$

Пример значения шаблона: Domain\userID

К началу

Примеры соответствия шаблону

В следующих примерах показаны успешные и неудачные соответствия шаблону, которые по-разному используются в полях.

Номер выпуска

Шаблон: ANN.NN.NN

Пройдут проверку	R01.03.04 или V05.08.99
Не пройдут проверку	1.3.4 или V5.8.99, или v1.3

Гибкий идентификатор

Шаблон: XXX-XXX

Пройдут проверку	001-abc или a00-b02
Не пройдут проверку	1-abc или 001.abc

Приоритет

Шаблон: PN

Пройдут проверку	P1 или P5 или P9
Не пройдут проверку	1 или P10

Шаблоны сравнения рассматриваются без учета регистра.Следовательно, "PN" соответствует и P1, и p1.

К началу

См. также

Другие ресурсы

Работа с правилами полей

Поделиться через