FIELD (ワークフロー) 要素リファレンス
FIELD (ワークフロー) 要素は、状態変更中、またはワークフロー遷移中にフィールドに対して適用される規則と条件を指定するために使用します。 規則は、親の FIELD 要素が子となる STATE、TRANSITION、DEFAULTREASON、または REASON 要素の下で FIELDS (ワークフロー) 要素が現れる位置に基づいて適用されます。 詳細については、「Q: フィールド規則はどこに適用する必要がありますか。」を参照してください。
注意
作業項目の種類のフィールドの定義に使用される FIELD (定義) 要素について詳しくは、「FIELD (定義) 要素リファレンス」を参照してください。
<FIELD refname="fieldReferenceName">
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE />
<CANNOTLOSEVALUE />
<COPY />
<DEFAULT />
<EMPTY />
<FROZEN />
<MATCH />
<NOTSAMEAS />
<PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
<READONLY />
<REQUIRED />
<SERVERDEFAULT />
<SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
<VALIDUSER />
<WHEN> . . . </WHEN>
<WHENNOT> . . . </WHENNOT>
<WHENCHANGED> . . . </WHENCHANGED>
<WHENNOTCHANGED> . . . </WHENNOTCHANGED>
<FIELD>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
refname |
必須。 規則および条件が適用されるフィールドの参照名。 参照名は、フィールド定義の FIELD (定義) 要素で定義されている参照名と一致する必要があります。 詳細については、「FIELD (定義) 要素リファレンス」を参照してください。 |
子要素
要素 |
説明 |
|---|---|
省略可能です。 フィールドの許可値のリストを定義します。 許可される値は、作業項目フォームのフィールド リストおよびクエリ ビルダーで選択可能な値です。 これらの値の 1 つを選択する必要があります。 |
|
省略可能です。 既存の値を許可するようにフィールドを定義します。 この要素は、既に存在するフィールド値が、たとえ無効値であっても使用できるようにします。 新しいフィールド値はすべて有効である必要があります。 |
|
省略可能です。 値を失わないフィールドとして定義します。 この要素を指定すると、現在のフィールド値が維持され、クリアすることも、空にすることもできません。 |
|
省略可能です。 現在のフィールドに値がコピーされる別のフィールドを指定します。 |
|
省略可能です。 フィールドの既定値を定義します。 |
|
省略可能です。 フィールドを空と定義します。 |
|
省略可能です。 フィールドを固定として定義します。 変更がコミットされた後、固定されたフィールドを空でない値に変更することはできません。 ただし、手動でフィールドをクリアし、作業項目を保存して、別の値を指定することはできます。 |
|
省略可能です。 フィールド値が一致する必要があるフィールドのパターンを定義します。 |
|
省略可能です。 現在のフィールドの値と一致する値を持つことができない別のフィールドを指定します。 |
|
省略可能です。 フィールドで禁止される値のリストを定義します。 |
|
省略可能です。 フィールドを読み取り専用として定義します。 |
|
省略可能です。 フィールドを必須として定義します。 |
|
省略可能です。 フィールドに値を設定するサーバー コンポーネントを指定します。 |
|
省略可能です。 フィールドで推奨される値のリストを定義します。 推奨値は、作業項目フォームのフィールド リストおよびクエリ ビルダーで選択可能な値です。 リストに含まれていない、他の値を入力することもできます。 |
|
省略可能です。 許容値のリストがシステム内の有効なユーザーのみで構成される必要があることを指定します。 |
|
省略可能です。 別のフィールドが特定の値を持つときに現在のフィールドに適用する 1 つまたは複数の規則を指定します。 |
|
省略可能です。 特定のフィールドの値が変更されたときに現在のフィールドに適用される 1 つ以上の規則を指定します。 |
|
省略可能です。 別のフィールドが特定の値ではないときに現在のフィールドに適用される 1 つ以上の規則を指定します。 |
|
省略可能です。 特定のフィールドの値が変更されないときに現在のフィールドに適用される 1 つ以上の規則を指定します。 |
親要素
要素 |
説明 |
|---|---|
作業項目の種類を定義するフィールドを参照し、そのフィールドに適用される規則および条件を指定する FIELD (ワークフロー) 要素のコレクション。 参照は、親の STATE 要素の子要素となる TRANSITION、DEFAULTREASON、REASON、FIELDS 要素に基づきます。 |
解説
FIELD (ワークフロー) 要素の少なくとも 1 つの子要素を定義する必要があります。
FIELD (ワークフロー) は、FIELDS (ワークフロー) の必須の子要素です。
minOccurs="1"
maxOccurs="unbounded"