WHEN, элемент (схема определения типа рабочего элемента)
Обновлен: Ноябрь 2007
Задает условие, при которым одно или несколько правил применяются к текущему полю. Правила применяются к текущему полю, если для другого поля установлено определенное значение. Текущее поле определяется родительским элементом.
<xs:element name="WHEN" type="FieldValueCondition"/>
Атрибуты и элементы
В следующих разделах описаны атрибуты и дочерние элементы, определяющие элемент WHEN. В них также описываются родительские элементы и определяется способ применения элемента WHEN. Должен быть определен хотя бы один дочерний элемент.
Атрибуты
Атрибут |
Описание |
|---|---|
field |
Обязательный атрибут. Определяет поле, для которого должно быть установлено указанное значение, чтобы правила данного элемента применялись к текущему полю. В этом атрибуте задается имя ссылки на поле. Дополнительные сведения о об именах ссылок см. в разделе Элемент FIELD (элемент WORKITEMTYPE). |
value |
Обязательный атрибут. Задает значение, которое должно быть задано для поля, определяемого атрибутом field, чтобы правила данного элемента применялись к текущему полю. |
Дочерние элементы
Элемент |
Описание |
|---|---|
REQUIRED, элемент (схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если для поля, определяемого атрибутом field, установлено указанное значение, то текущее поле (поле, которое содержит элемент WHEN) должно содержать значение. |
READONLY, элемент (схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если для поля, определяемого атрибутом field, установлено указанное значение, текущее поле доступно только для чтения. |
Необязательный элемент. Задает, что если для поля, определяемого атрибутом field, установлено указанное значение, то текущее поле не должно содержать значения. |
|
Необязательный элемент. Задает, что если для поля, определяемого атрибутом field, установлено указанное значение, текущее поле зафиксировано. После фиксации изменений значение зафиксированного поля не может быть изменено на какое-либо другое непустое значение. Однако пользователь может вручную очистить поле, сохранить рабочий элемент, и затем указать другое значение. |
|
Элемент CANNOTLOSEVALUE (Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, не меняется, текущее поле не может быть очищено и не может получить пустое значение после того, как для него установлено какое-то значение. |
Элемент NOTSAMEAS (Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, значение текущего поля не может совпадать со значением третьего поля. Третье поле задается в элементе NOTSAMEAS. |
VALIDUSER, элемент (схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, то список допустимых значений должен состоять только из допустимых имен пользователей системы. |
Элемент ALLOWEXISTINGVALUE (Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, уже существующее значение текущего поля будет разрешено, даже если оно нарушает другие правила. Если значение текущего поля меняется, действие этого элемента отменяется. |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, значение текущего поля должно соответствовать указанному шаблону. |
|
Элемент ALLOWEDVALUES(Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, текущее поле должно иметь значение из определенного списка значений. Допустимыми являются значения, которые можно выбрать в списке полей в формах рабочих элементов и в построителе запросов. Необходимо выбрать одно из этих значений. |
Элемент SUGGESTEDVALUES (Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, то предлагаемые значения для текущего поля содержатся в определенном списке. Предлагаемые значения — это значения, которые можно выбрать в списке полей в формах рабочих элементов и в построителе запросов. Помимо значений, представленных в списке, можно ввести другие значения. |
PROHIBITEDVALUES, элемент (схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, текущее поле не может содержать значений из данного списка. |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, то значение по умолчанию для текущего поля задается данным элементом. |
|
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, значение из третьего поля автоматически копируется в текущее поле. Третье поле задается в элементе COPY. |
|
Элемент SERVERDEFAULT (Схема определения типа рабочего элемента) |
Необязательный элемент. Задает, что если значение поля, определяемого атрибутом field, равняется указанному значению, то текущее поле использует значение заданного серверного компонента. Серверными компонентами могут быть clock, т.е. время обновления рабочего элемента, и currentuser, т.е. учетная запись, обновившая рабочий элемент. |
Родительские элементы
Элемент |
Описание |
|---|---|
Обязательный элемент. Ссылается на определение поля рабочего элемента и применимые к этому полю правила и условия. Ссылка зависит от элемента STATE, TRANSITION, DEFAULTREASON или REASON, по отношению к которому ее родительский элемент FIELDS является дочерним. |
|
Обязательный элемент. Определяет поле рабочего элемента и задает применимые к нему правила и условия. |
Заметки
WHEN является необязательным дочерним элементом элементов FIELD (схема определения типа рабочего элемента) и FIELD (элемент WORKITEMTYPE).
Пример
<WHEN 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>
</WHEN>
Сведения об элементе
Пространство имен |
https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef |
Имя схемы |
Определение типа рабочего элемента |
Файл проверки |
WorkItemTypeDefinition.xsd |
Тип элемента |
Сложный тип FieldValueCondition (схема определения типа рабочего элемента) |
Может быть пустым |
Нет |