Элемент WHENNOTCHANGED (схема определения типа рабочего элемента)
Обновлен: Ноябрь 2007
Задает условие, при котором одно или несколько правил применяются к текущему полю. Правила применяются к текущему полю в том случае, если в редакции не изменяется значение другого поля. Текущее поле определяется родительским элементом.
<xs:element name="WHENNOTCHANGED" type="FieldCondition"/>
Атрибуты и элементы
В следующих разделах описаны атрибуты и дочерние элементы, определяющие элемент WHENNOTCHANGED. Также приводится описание родительских элементов, определяющих способ применения элемента WHENNOTCHANGED. Должен быть определен хотя бы один дочерний элемент.
Атрибуты
Атрибут |
Описание |
|---|---|
field |
Обязательный атрибут. Определяет поле, которое не должно изменяться, чтобы правила этого элемента применялись к текущему полю. В этом атрибуте задается имя ссылки на поле. Дополнительные сведения об именах ссылок см. в разделе Элемент FIELD (элемент WORKITEMTYPE). |
Дочерние элементы
Элемент |
Описание |
|---|---|
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 является дочерним. |
|
Обязательный элемент. Определяет поле рабочего элемента и задает применимые к нему правила и условия. |
Заметки
WHENNOTCHANGED является необязательным дочерним элементом элементов FIELD (схема определения типа рабочего элемента) и FIELD (элемент WORKITEMTYPE).
Пример
<WHENNOTCHANGED 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>
</WHENNOTCHANGED>
Сведения об элементе
Пространство имен |
https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef |
Имя схемы |
Определение типа рабочего элемента |
Файл проверки |
WorkItemTypeDefinition.xsd |
Тип элемента |
Сложный тип FieldCondition (схема определения типа рабочего элемента) |
Может быть пустым |
Нет |