すべての FIELD XML 要素のリファレンス

ALLOWEDVALUES

ユーザーが作業項目フォームのフィールド リストおよびクエリ エディターで指定できる値のリストを定義します。 ユーザーは、このリストのいずれか 1 つの値を指定する必要があります。

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

詳細については、「選択リストの定義」を参照してください。

CANNOTLOSEVALUE

値を指定した後にユーザーがフィールドから値をクリアできないように指定します。 フィールドに値を格納した後は、NULL 以外の値を常にフィールドに格納する必要があります。

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

詳細については、「作業項目フィールドの条件の設定」を参照してください。

DEFAULT

ユーザーが作業項目を作成または変更するときに、空のフィールドに値を指定します。 フィールドに既に値がある場合は、既定の規則は無視されます。

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

詳細については、「既定値の定義またはフィールドへの値のコピー」を参照してください。

FROZEN

変更がコミットされた後、フィールドを空でない値に変更できないように指定します。 ユーザーがこのフィールドの値を使用して作業項目を保存した後、フィールドの値を変更することはできません。

<FROZEN for="userGroupName" not="userGroupName" />

詳細については、「作業項目フィールドの条件の設定」を参照してください。

MATCH

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

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

詳細については、「文字列フィールドとパターンの一致」を参照してください。

PROHIBITEDVALUES

フィールドに格納できない値のリストを定義します。 フィールドに禁止値が設定されている場合は、ユーザーは作業項目を保存できません。

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

詳細については、「選択リストの定義」を参照してください。

REQUIRED

ユーザーがフィールドの値を指定する必要があるように指定します。 必須フィールドは空にできません。 ユーザーは、すべての必須フィールドに値を割り当てるまでは作業項目を保存できません。

<REQUIRED for="userGroupName" not="userGroupName" />

詳細については、「作業項目フィールドの条件の設定」を参照してください。

SUGGESTEDVALUES

ユーザーが作業項目フォームのフィールド リストおよびクエリ エディターで指定できる推奨値のリストを定義します。 ユーザーは、推奨値以外の値を指定することもできます。

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

詳細については、「選択リストの定義」を参照してください。

WHEN

別のフィールドが特定の値を持つときに現在のフィールドに適用する 1 つまたは複数の規則を指定します。 現在のフィールドは、親 FIELD 要素によって定義されます。

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

詳細については、「条件付き値および条件付き規則の割り当て」を参照してください。

WHENCHANGED

作業項目のリビジョン中に別のフィールドが変更された場合に現在のフィールドに適用される 1 つ以上の規則を指定します。 現在のフィールドは、親 FIELD 要素によって定義されます。

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

詳細については、「条件付き値および条件付き規則の割り当て」を参照してください。

GLOBALIST

<GLOBALLIST name="globalListName
">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST> 

チーム プロジェクト コレクション用に保存され、コレクション内のすべてのチーム プロジェクトで使用できる一連の LISTITEM 要素を定義します。

globalListName: 1 ～ 255 文字で構成されたテキスト文字列です。

GLOBALLIST は、GLOBALLISTS 要素の必須の子要素であり、ALLOWEDVALUES 要素、SUGGESTEDVALUES 要素、および PROHIBITEDVALUES 要素の省略可能な子要素です。 グローバル リストは、作業項目の定義、グローバル リストの定義、またはグローバル ワークフロー内で定義できます。

expanditems

expanditems="true | false"

省略可能。 LISTITEM 要素によって指定されたグループを拡張してリスト内の下位グループも含めるかどうかを指定します。 この属性の既定値は true です。

for

for="userGroupName"

省略可能。 この規則を適用する Team Foundation のユーザーまたはグループの名前を指定します。 有効な値は、1 ～ 255 文字のテキスト文字列で構成されます。

from

from="value | field | clock | currentuser"

必須。 値のコピー元または既定値の指定元となる値のソースを指定します。 有効な値は、次のとおりです。

• clock:  システム時計から現在の日付と時刻を DateTime フィールドにコピーします。追加の属性は必要ありません。 COPY 規則と DEFAULT 規則の場合、この値はローカル コンピューターのクロック時間から取得されます。 SERVERDEFAULT の場合、この値はユーザーが作業項目を保存するときにサーバー クロックから取得されます。

• currentuser: 現在ログオンしているユーザーの名前をコピーします。 現在のユーザーの短いユーザー名を値として使用します。 他の属性は必要ありません。 文字列のフィールドに使用します。

• field: 指定した field 属性の値をコピーします。 field="abc" 属性が必須です。 既定では、指定された "from" フィールドが空白であれば、何も実行されません。 field 属性は、<COPY> 規則と <DEFAULT> 規則に対してのみ使用されます。

• value: 指定した value 属性の値をコピーします。 指定した文字列定数の値を使用します。 value="abc" 属性が必須です。 value は、<COPY> 規則と <DEFAULT> 規則に対してのみ使用されます。

"value" または "field" を指定する場合には、値またはフィールドの属性をそれぞれ含める必要があります。

value

value="valueToCopy"

省略可能。 value が from 属性に指定されている場合、フィールドにコピーされる値を指定します。

2011 年 1 月

すべての FIELD 子要素の構文を提供し、削除されたトピックへのリンクを削除。

情報の拡充