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


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

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

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

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

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

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

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

            Элемент FIELD (элемент 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)

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

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

Заметки

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 (Схема определения типа рабочего элемента)

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

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

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