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

Статья
11/05/2008

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

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

<xs:element name="WHENCHANGED" type="FieldCondition"/>

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

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

Атрибуты

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

field

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

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

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

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

Элемент	Описание
REQUIRED, элемент (схема определения типа рабочего элемента)	Необязательный элемент. Задает, что если меняется значение поля, определяемого атрибутом field, то текущее поле (поле, которое содержит элемент WHENCHANGED) должно иметь значение.
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)

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

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

Заметки

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

Пример

<WHENCHANGED field="field reference name">
    <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>
</WHENCHANGED>

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

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

См. также

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

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

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

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