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

Статья
06/09/2015

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

Примечание

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

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

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

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

Атрибуты

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

Атрибут	Описание
pattern	Обязательный. Принудительно применяет базовое сопоставление шаблонов только для строк, которые syncnamechanges="false". Допустимые значения для 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

Обязательный. Принудительно применяет базовое сопоставление шаблонов только для строк, которые syncnamechanges="false".

Допустимые значения для 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.

К началу

См. также

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

Применение правила к полю рабочего элемента

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