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

Статья
11/05/2008

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

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

Иерархия схемы

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

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

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
name	Обязательный атрибут FieldDefinition. Отображаемое имя поля, к которому применяются правила и условия. Дополнительные сведения см. в разделе Имена полей.
refname	Обязательный атрибут FieldDefinition. Имя ссылки поля, к которому применяются правила и условия. Имя ссылки должно совпадать с именем ссылки, определенном в элементе FIELD определения поля. Дополнительные сведения см. в разделе Ссылочные имена полей.
type	Обязательный атрибут FieldDefinition. Тип значения, принимаемого полем. Дополнительные сведения см. в разделе Типы полей.
reportable	Необязательный атрибут FieldDefinition. Данные из поля будут экспортированы в хранилище данных и могут включаться в отчеты. Дополнительные сведения см. в разделе Использование полей для отчетов.
formula	Необязательный атрибут FieldDefinition. Тип агрегата для отчетного типа measure. В настоящее время sum является единственным поддерживаемым типом агрегата для типа measure. Дополнительные сведения см. в разделе witfields.

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

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

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

Элемент	Описание
Элемент FIELDS (элемент WORKITEMTYPE)	Обязательный элемент. Содержит определения полей типа рабочего элемента.

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

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

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

Заметки

FIELD является обязательным дочерним элементом элемента FIELDS.

minOccurs="1"

maxOccurs="unbounded"

Пример

<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
    <HELPTEXT>…</HELPTEXT>
    <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>…</WHEN>
    <WHENNOT>…</WHENNOT>
    <WHENCHANGED>…</WHENCHANGED>
    <WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>

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

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

См. также

Ссылки

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

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

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

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

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