次の方法で共有


FIELD 要素 (作業項目の種類の定義スキーマ)

更新 : 2007 年 11 月

作業項目フィールドの定義と、フィールドに適用される規則および条件を参照します。この参照は、親の FIELDS 要素の親である STATE 要素、TRANSITION 要素、DEFAULTREASON 要素、または REASON 要素に基づきます。

<xs:element name="FIELD" type="FieldReference" minOccurs="1" maxOccurs="unbounded"/>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

説明

refname

必須の FieldReference 属性です。

規則と条件を適用するフィールドの参照名です。参照名は、フィールド定義の FIELD 要素で定義されている参照名と一致する必要があります。詳細については、「FIELD 要素 (WORKITEMTYPE 要素)」を参照してください。

子要素

要素

説明

REQUIRED 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドを必須と定義します。

READONLY 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドを読み取り専用と定義します。

EMPTY 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドを空と定義します。

FROZEN 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドを固定として定義します。変更がコミットされた後、固定されたフィールドを空でない値に変更することはできません。ただし、手動でフィールドをクリアし、作業項目を保存して、別の値を指定することはできます。

CANNOTLOSEVALUE 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

値を失わないフィールドとして定義します。つまり、現在のフィールドに値が取得された後、その値をクリアすることやフィールドを空にすることはできません。

NOTSAMEAS 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

現在のフィールドの値と同じにすることができない値のソースとして別のフィールドを指定します。

VALIDUSER 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

許容値のリストがシステム内の有効なユーザーのみで構成される必要があることを指定します。

ALLOWEXISTINGVALUE 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

既存の値が許可されるフィールドとして定義します。つまり、既に存在するフィールド値は、たとえ無効値であっても許可されます。新しいフィールド値は有効である必要があります。

MATCH 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールド値が一致する必要があるフィールドのパターンを定義します。

ALLOWEDVALUES 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドの許可値のリストを定義します。許容される値は、作業項目フォームのフィールド リストおよびクエリ ビルダで選択可能な値です。これらの値の 1 つを選択する必要があります。

SUGGESTEDVALUES 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドの推奨値のリストを定義します。推奨値は、作業項目フォームのフィールド リストおよびクエリ ビルダで選択可能な値です。リストに含まれていない、他の値を入力することもできます。

PROHIBITEDVALUES 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドの禁止値のリストを定義します。

DEFAULT 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

フィールドの既定値を定義します。

COPY 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

現在のフィールドにコピーされる値のソースとして、別のフィールドを指定します。

SERVERDEFAULT 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

このフィールドの値のソースとしてサーバー コンポーネントを指定します。

WHEN 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

別のフィールドが特定の値を持つときに現在のフィールドに適用する 1 つまたは複数の規則を指定します。

WHENNOT 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

別のフィールドが特定の値を持たないときに現在のフィールドに 1 つまたは複数の規則を適用します。

WHENCHANGED 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

特定のフィールドが変更されたときに現在のフィールドに 1 つまたは複数の規則を適用します。

WHENNOTCHANGED 要素 (作業項目の種類の定義スキーマ)

省略可能な要素

特定のフィールドが変更されないときに現在のフィールドに 1 つまたは複数の規則を適用します。

親要素

要素

説明

FIELDS 要素 (作業項目の種類の定義スキーマ)

作業項目の種類に含まれるフィールド定義を参照する FIELD 要素のコレクションです。

解説

FIELD (作業項目の種類の定義スキーマ) 要素の子要素を少なくとも 1 つ定義する必要があります。

FIELD は、FIELDS に必須の子要素です。

minOccurs="1"

maxOccurs="unbounded"

使用例

<FIELD refname="field reference name">
    <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

要素の型

FieldReference 複合型 (作業項目の種類の定義スキーマ)

空も使用できる

いいえ

参照

その他の技術情報

作業項目の種類の定義スキーマ

作業項目の種類フィールドの定義