共用方式為

所有 FIELD XML 項目參考

  • 發行項

您可以使用本主題中的資訊，快速參考所有用於定義工作項目類型之資料欄位的項目和主要屬性。 您可以在 FIELD (定義) 項目容器中指定這些項目。 在 FIELDS (定義) 項目內指定 FIELD (定義) 項目，即可在工作項目類型中加入欄位。 這些項目可以在工作項目類型的定義中指定，或做為全域工作流程的一部分。 您可以建立本主題描述的子項目，以指定欄位的行為、定義預設值或定義值的挑選清單。 您可以相互搭配每個欄位規則項目使用。 大部分規則都可以將範圍設定為套用至一個或多個使用者或群組，或由一個或多個使用者或群組所忽略。

FIELD 項目的所有子項目都是選擇性的。 除了 HELPTEXT 項目，您可以指定所有項目做為 FIELD (定義)、FIELD (工作流程) 和 FIELD (全域工作流程) 項目的子項目。 您可以使用 FIELD (定義) 項目來定義工作項目欄位，以及指定套用至該欄位的規則和條件。 您可以指定 FIELD (工作流程) 項目的規則，來定義欄位值或將規則套用至欄位，做為工作項目從某個狀態到另一個狀態的轉換。 您可以根據父 FIELDS 項目為其子系的 STATE、TRANSITION、DEFAULTREASON 或 REASON 項目，指定欄位規則。 如需詳細資訊，請參閱使用工作項目欄位與設計工作流程。

本主題內容

  • FIELD (定義) 容器項目

  • FIELD 子項目

  • GLOBALLIST 和 LISTITEM 子項目

  • 由 FIELD 子項目指定的屬性

FIELD (定義) 容器項目

您可以使用下列語法來定義工作項目類型的資料欄位。 這個範例顯示 FIELD (定義) 項目和所有選擇性子項目的格式。 如需詳細資訊，請參閱FIELD (定義) 項目。

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

FIELD 子項目

下表說明子項目，您可以用來指定在指派欄位值時要套用的規則。 所有子項目都是選擇性的。 大部分子項目都可以將範圍設定為只套用至單一群組或除單一群組的使用者外的所有人。

元素

描述和語法

ALLOWEDVALUES

定義值清單，使用者可以在工作項目表單和查詢編輯器的欄位清單中指定這些值。 使用者必須指定在清單上的其中一個值

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

如需詳細資訊，請參閱定義挑選清單。

ALLOWEXISTINGVALUE

指定欄位可以保留現有的值，即使這個值已經不存在挑選清單中。 所有新欄位值都必須在清單中。

<ALLOWEXISTINGVALUE />

如需詳細資訊，請參閱定義挑選清單。

CANNOTLOSEVALUE

指定使用者在指定值之後不可清除欄位的所有值。 在欄位包含值之後，該欄位就一定要包含非 NULL 的值。

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

如需詳細資訊，請參閱設定工作項目欄位的條件。

COPY

在使用者建立或修改工作項目時，複製指定值到欄位。

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

如需詳細資訊，請參閱定義預設值或將值複製到欄位。

DEFAULT

在使用者建立或修改工作項目時，為空白欄位指定值。 如果欄位已經填入某個值，就會忽略 default 規則

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

如需詳細資訊，請參閱定義預設值或將值複製到欄位。

EMPTY

清除欄位中的所有值。 EMPTY 規則也會使欄位變成唯讀，不應與 READONLY 規則一起使用。

欄位值在使用者儲存工作項目時會被清除，而且您無法指定任何值。 這項規則主要是用於狀態轉換期間，以清除適用於項目轉換目標狀態的欄位。

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

如需詳細資訊，請參閱設定工作項目欄位的條件。

FROZEN

指定在認可變更之後，就不能將欄位變更為任何非空白的值。 一旦使用者以該欄位的值儲存工作項目後，就無法再修改這個值。

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

如需詳細資訊，請參閱設定工作項目欄位的條件。

HELPTEXT

定義當使用者指向工作項目表單的欄位時顯示的文字。

tooltipText：由 1 到 255 個字元組成的文字字串。

<HELPTEXT>tooltipText </HELPTEXT>

如需詳細資訊，請參閱定義工作項目欄位的說明文字。

MATCH

定義 String 型別欄位的值必須符合的模式。

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

如需詳細資訊，請參閱讓字串欄位符合模式。

NOTSAMEAS

指定欄位和另一指定欄位不會被指派相同值。 field 屬性的值必須是有效的欄位參考名稱。

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

如需詳細資訊，請參閱設定工作項目欄位的條件。

PROHIBITEDVALUES

定義欄位不可包含的值清單。 如果欄位包含禁止使用的值，使用者就無法儲存工作項目。

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

如需詳細資訊，請參閱定義挑選清單。

READONLY

您不可修改指派給欄位的值。

<READONLY for="userGroupName" not="userGroupName" />
注意事項注意事項
請不要將這個項目與 EMPTY 項目一起使用，因為 EMPTY 也會使欄位變成唯讀。如果結合這些項目，結果會不一致。

如需詳細資訊，請參閱設定工作項目欄位的條件。

REQUIRED

指定使用者必須指定欄位值。 必要欄位不得為空白。 使用者必須指派值給所有必要欄位，才能儲存工作項目。

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

如需詳細資訊，請參閱設定工作項目欄位的條件。

SERVERDEFAULT

在使用者儲存工作項目時，將指定的伺服器值複製到欄位。 這些欄位通常會以唯讀狀態出現在表單上。

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

如需詳細資訊，請參閱定義預設值或將值複製到欄位。

SUGGESTEDVALUES

定義建議值的清單，使用者可以在工作項目表單和查詢編輯器的欄位清單中指定這些值。 使用者指定的值可以不是您建議的值。

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

如需詳細資訊，請參閱定義挑選清單。

VALIDUSER

限制屬於指定之群組的使用者不可修改工作項目。 預設群組是 Team Foundation Valid Users 群組。

所有屬性都是選擇性的。 所有屬性都必須由介於 1 到 255 個字元之間的文字字串所組成。 您可以使用語彙基元指定群組。 如需詳細資訊，請參閱使用語彙基元參考使用者和群組。

< VALIDUSER group="groupName" for="userName" not="userName" />

如需詳細資訊，請參閱管理用於建立或修改工作項目的權限。

WHEN

當其他欄位擁有特定值時，指定要套用到目前欄位的一個或多個規則。 父 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>

如需詳細資訊，請參閱指派以條件為基礎的值和規則。

WHENNOT

當其他欄位沒有特定值時，指定要套用到目前欄位的一個或多個規則。 父 FIELD 項目定義目前的欄位。

<WHENNOT 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>
</WHENNOT>

如需詳細資訊，請參閱指派以條件為基礎的值和規則。

WHENCHANGED

指定當另一個欄位在工作項目修訂期間變更時，要套用至目前欄位的一個或多個規則。 父 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>

如需詳細資訊，請參閱指派以條件為基礎的值和規則。

WHENNOTCHANGED

指定當另一個欄位在工作項目修訂期間未變更時，要套用至目前欄位的一個或多個規則。 父項目定義了目前的欄位。

<WHENNOTCHANGED 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>
</WHENNOTCHANGED>

如需詳細資訊，請參閱指派以條件為基礎的值和規則。

GLOBALLIST 和 LISTITEM 子項目

下表描述 GLOBALLIST 和 LISTITEM 項目。 您可以將這些項目指定為 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 項目的子項目。 您可以使用這些項目來列舉值清單，做為項目的挑選清單或下拉式功能表供使用者指定。 如需詳細資訊，請參閱定義使用者清單、挑選清單和全域清單。

元素

語法

描述

GLOBALIST

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

定義一組由 Team 專案集合所儲存且可供集合中所有 Team 專案使用的 LISTITEM 項目。

globalListName：由 1 到 255 個字元組成的文字字串。

GLOBALLIST 是 GLOBALLISTS 項目的必要子項目，以及 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 項目的選擇性子項目。 您可以在工作項目定義、全域清單定義或在全域工作流程內定義全域清單。

LISTITEM

 
<LISTITEM value="listName" />

定義有效的清單值。

LISTITEM 是 GLOBALLIST 的必要子項目，以及 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 項目的選擇性子項目。

回到頁首

由 FIELD 子項目指定的屬性

您可以藉由包含 for 或 not 屬性，將大部分 FIELD 規則限定為要套用或不套用至一組群組或使用者。 如需詳細資訊，請參閱設定群組做為欄位規則的範圍。

屬性

語法

描述

expanditems

expanditems="true | false"

選擇項。 指定 LISTITEM 項目所識別的群組是否應該擴展成包括清單中的附屬群組。 此屬性的預設值為 true。

filteritems

filteritems="excludegroups"

選擇項。 指定淸單中只會包含群組的成員，不會包含群組名稱。 這個屬性的唯一允許值是 excludegroups。

for

for="userGroupName"

選擇項。 指定適用規則之 Team Foundation 使用者或群組的名稱。 有效值由介於 1 到 255 個字元之間的文字字串所組成。

not

not="userGroupName"

選擇項。 指定不適用規則之 Team Foundation 使用者或群組的名稱。 有效值由介於 1 到 255 個字元之間的文字字串所組成。

from

from="value | field | clock | currentuser"

必要項。 指定值的來源，以複製值或指定預設值。 下列是有效值：

  • clock：從系統時間複製目前的日期和時間至[日期時間]欄位。不需要任何其他屬性。 如果是 COPY 和 DEFAULT 規則，這個值是來自本機電腦時鐘時間。 如果是 SERVERDEFAULT，這個值是在使用者儲存工作項目時取自伺服器時鐘。

  • currentuser：複製目前登入使用者的名稱。 使用目前使用者的簡短使用者名稱做為欄位值， 不需要任何其他屬性。 適用於字串欄位

  • field：複製指定之 field 屬性的值。 必須具有 field="abc" 屬性。 根據預設，如果指定的 "from" 欄位是空的，則不會執行任何動作。 只有 <COPY> 和 <DEFAULT> 規則才會使用 field 屬性。

  • value：複製指定之 value 屬性的值。 使用指定之字串常數的值， 必須具有 value="abc" 屬性。 只有 <COPY> 和 <DEFAULT> 規則才會使用 value。

如果您指定了 "value" 或 "field"，則也必須分別包含 value 或 field 屬性。

field

field="fieldReferenceName"

選擇項。 指定欄位的名稱，為 from 屬性指定 field 時，其值要複製到此欄位。

pattern

pattern= "patternValue」

必要項。 只會對字串強制施行基本模式比對， patternValue 是由介於 1 到 255 個字元的字串，其中包含。 該字串不能包含反斜線字元 (\)。 除非它是下列六個中繼字元之一，字串中的字元解譯為常值:

  • 「A」或「a」代表單一字母字元。

  • 「N」或「n」代表單一數字字元。

  • 「X」或「x」表示單一英數字元。

模式值：^[^\\]*$

例如， pattern="xxxxx.nn.nn" 符合任何五個英數字元，然後期間，接著兩個數字字元，然後期間，接著兩個數字字元。

value

value="valueToCopy"

選擇項。 針對 from 屬性指定 value 時，指定要複製到欄位的值。

回到頁首

請參閱

概念

定義使用者清單、挑選清單和全域清單

使用工作項目欄位

設計工作流程