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


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

Обновлен: Ноябрь 2007

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

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

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

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

Атрибуты

Атрибут

Описание

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)

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

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

Заметки

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

Пример

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

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

Пространство имен

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Имя схемы

Определение типа рабочего элемента

Файл проверки

WorkItemTypeDefinition.xsd

Тип элемента

Сложный тип FieldValueCondition (схема определения типа рабочего элемента)

Может быть пустым

Нет

См. также

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

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

Условия полей