共用方式為


設定工作項目欄位的條件

您可以指定限定規則,例如 CANNOTLOSEVALUE、EMPTY、FROZEN、NOTSAMEAS、READONLY 和 REQUIRED 項目,藉以限制欄位不得變更。 例如,您可以使用 NOTSAMEAS 規則,防止指派相同值給兩個欄位或同時清除這些欄位, 此外,您也可以使用該規則,防止將相同值指派給 [程式碼檢閱者] 欄位與 [指派給] 欄位。

您可以指定這些規則做為 FIELD (定義)、FIELD (工作流程) 或 FIELD (全域工作流程) 項目的子項目。 您可以分別針對 for 或 not 屬性指定使用者或群組,藉以根據修改工作項目的人員套用或忽略這些規則。

欄位值規則項目的語法結構

  • 您可以指定 CANNOTLOSEVALUE 規則,以防止欄位在指定值後被清除。 如果將這個規則套用至欄位,則在使用者將該欄位設為任何值之後,該欄位必須永遠包含非 NULL 值。

    <CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
    
  • 指定 EMPTY 規則以清除欄位包含的任何值。 這個規則也會使欄位變成唯讀,不應與 READONLY 規則一起使用。 欄位值在您儲存工作項目時會被清除,而且您無法指定任何值。 這個規則主要是用於狀態轉換期間,以清除適用於工作項目轉換目標狀態的欄位。

    <EMPTY for="userGroupName"not="userGroupName" />
    
  • 指定 FROZEN 規則,以防止使用者在儲存工作項目之後將欄位變更為非 NULL 值。 一旦在資料庫中定義欄位的值之後,就無法再修改這個值。

    <FROZEN for="userGroupName" not="userGroupName" />
    
  • 指定 NOTSAMEAS 規則,以防止欄位與另一個欄位被指派相同值。 field 屬性必須是有效的欄位參考名稱。

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

    例如,下列摘錄會防止欄位具有與 MyCorp.Reviewer 欄位相同的值:

    <NOTSAMEAS field="MyCorp.Reviewer" />
    

    請針對屬於相同型別的欄位使用這項規則。 您無法將這項規則用於 PlainText 或 HTML 欄位。

  • 指定 READONLY 規則以防止欄位值變更。

    請不要將這個項目與 EMPTY 項目一起使用,因為 EMPTY 也會使欄位變成唯讀。 如果將這兩個項目一起使用,可能會產生不一致的結果。

    <READONLY for="userGroupName" not="userGroupName" />
    
  • 指定 REQUIRED 規則以要求使用者必須指定欄位值。 必要欄位不得為空白。 使用者必須定義所有必要欄位,才能儲存工作項目。

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

回到頁首

屬性

您可以限制適用限定規則的人員。 下表描述這些項目所參考的屬性:

屬性

描述

for

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

模式值:^[^\\]+\\[^\\]+$

模式值範例:Domain\UserID

not

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

模式值:^[^\\]+\\[^\\]+$

模式值範例:Domain\UserID

field

NOTSAMEAS 項目所需。 指定欄位的參考名稱,目前欄位不可包含此欄位的值。

此參考名稱必須符合 FIELD (定義) 項目所定義的參考名稱。 如需詳細資訊,請參閱 FIELD (定義) 項目

模式值:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

模式值範例:Company.Division.IssueType

回到頁首

請參閱

概念

所有 FIELD XML 項目參考

使用語彙基元參考使用者和群組

其他資源

管理用於建立或修改工作項目的權限

使用欄位規則

定義工作項目欄位