Элемент WHENNOT (схема определения типа рабочего элемента)

Статья
05/19/2010

Задает условие, при котором одно или несколько правил применяются к текущему полю.Правила применяются к текущему полю, если другое поле не имеет определенного значения.Текущее поле определяется родительским элементом.

<xs:element name="WHENNOT" type="FieldValueCondition"/>

<WHENNOT field="field reference name" value="value">
   <ALLOWEDVALUES> .  .  .  </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> .  .  .  </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> .  .  .  </SUGGESTEDVALUES>
   <VALIDUSER />
</WHENNOT>

Атрибуты и элементы

В следующих разделах описаны атрибуты и дочерние элементы, определяющие элемент WHENNOT.Также приводится описание родительских элементов, определяющих способ применения элемента WHENNOT.Должен быть определен хотя бы один дочерний элемент.

Атрибуты

Attribute	Описание
field	Обязательный атрибут. Определяет поле, для которого должно быть установлено указанное значение, чтобы правила данного элемента применялись к текущему полю. В этом атрибуте задается имя ссылки на поле.Дополнительные сведения о об именах ссылок см. в разделе Элемент FIELD (элемент WORKITEMTYPE).
value	Обязательный атрибут. Задает значение, которое не должно содержать поле, определяемое атрибутом field, для того, чтобы правила в данном элементе применялись к текущему полю.

field

Обязательный атрибут.

Определяет поле, для которого должно быть установлено указанное значение, чтобы правила данного элемента применялись к текущему полю.

В этом атрибуте задается имя ссылки на поле.Дополнительные сведения о об именах ссылок см. в разделе Элемент FIELD (элемент WORKITEMTYPE).

value

Обязательный атрибут.

Задает значение, которое не должно содержать поле, определяемое атрибутом field, для того, чтобы правила в данном элементе применялись к текущему полю.

Дочерние элементы

Элемент	Описание
Элемент REQUIRED (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то текущее поле (поле, которое содержит элемент WHENNOT) должно содержать значение.
Элемент READONLY (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то текущее поле доступно только для чтения.
Элемент EMPTY (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то текущее поле не должно содержать значения.
Элемент FROZEN (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то текущее поле является зафиксированным.После фиксации изменений зафиксированному полю не может быть присвоено непустое значение.Однако пользователь может вручную очистить поле, сохранить рабочий элемент, и затем указать другое значение.
Элемент CANNOTLOSEVALUE (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, не меняется, текущее поле не может быть очищено и не может получить пустое значение после того, как для него установлено какое-то значение.
Элемент NOTSAMEAS (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то значение текущего поля не может совпадать со значением третьего поля.Третье поле задается в элементе NOTSAMEAS.
Элемент VALIDUSER (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то список допустимых значений должен состоять только из допустимых имен пользователей системы.
Элемент ALLOWEXISTINGVALUE (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то значение существующего текущего поля будет разрешено, даже если оно нарушает другие правила.Если значение текущего поля меняется, действие этого элемента отменяется.
Элемент MATCH (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то значение текущего поля должно соответствовать заданному шаблону.
Элемент ALLOWEDVALUES(схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то текущее поле должно содержать значение из заданного списка значений.Допустимыми являются значения, которые можно выбрать в списке полей в формах рабочих элементов и в построителе запросов.Необходимо выбрать одно из этих значений.
Элемент SUGGESTEDVALUES (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то заданный список содержит предлагаемые значения для текущего поля.Предлагаемые значения — это значения, которые можно выбрать в списке полей в формах рабочих элементов и в построителе запросов.Помимо значений, представленных в списке, можно ввести другие значения.
Элемент PROHIBITEDVALUES (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанное значение, то текущее поле не может содержать значений из списка.
Элемент DEFAULT (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то данный элемент задает значение по умолчанию для текущего поля.
Элемент COPY (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то значение из третьего поля автоматически копируется в текущее поле.Третье поле задается в элементе COPY.
Элемент SERVERDEFAULT (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если поле, определяемое атрибутом field, не содержит указанного значения, то текущее поле использует значение указанного серверного компонента.Серверными компонентами могут быть clock, т.е. время обновления рабочего элемента, и currentuser, т.е. учетная запись, обновившая рабочий элемент.

Родительские элементы

Элемент	Описание
Элемент FIELD (схема определения типа рабочего элемента)	Обязательный элемент. Ссылается на определение поля рабочего элемента и применимые к этому полю правила и условия.Ссылка зависит от элемента STATE, TRANSITION, DEFAULTREASON или REASON, по отношению к которому ее родительский элемент FIELDS является дочерним.
Элемент FIELD (элемент WORKITEMTYPE)	Обязательный элемент. Определяет поле рабочего элемента и задает применимые к нему правила и условия.

Элемент FIELD (схема определения типа рабочего элемента)

Обязательный элемент.

Ссылается на определение поля рабочего элемента и применимые к этому полю правила и условия.Ссылка зависит от элемента STATE, TRANSITION, DEFAULTREASON или REASON, по отношению к которому ее родительский элемент FIELDS является дочерним.

Элемент FIELD (элемент WORKITEMTYPE)

Обязательный элемент.

Определяет поле рабочего элемента и задает применимые к нему правила и условия.

Заметки

WHENNOT является необязательным дочерним элементом элементов FIELD (схема определения типа рабочего элемента) и FIELD (элемент WORKITEMTYPE).

Сведения об элементе

Namespace	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Имя схемы	Определение типа рабочего элемента
Файл проверки	WorkItemTypeDefinition.xsd
Тип элемента	Сложный тип FieldValueCondition (схема определения типа рабочего элемента)
Может быть пустым	Нет

См. также

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

Схема определения типа рабочего элемента

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

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