規則和規則評估
本文內容
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018
規則可用來設定或限制工作專案欄位的值指派。 有兩種主要類型的規則：自動產生的規則和針對進程或專案定義的自訂規則。 自動產生的規則可將應該以標準方式運作的區域新增自訂規則的需求降到最低。
您可以定義自訂規則以支援您的商務使用案例。 視欄位的資料類型而定，您可以針對哪些資料可以輸入該欄位來設定各種限制。 您可以指定挑選清單 (下拉式功能表) 的值、設定預設值、清除項目，或限制變更。 透過條件式規則，您可以根據不同欄位值之間的相依性，將規則套用至欄位。 您也可以限制可修改欄位的人員，或將規則的範圍設為僅套用至群組。
請閱讀本文以瞭解下列內容：
系統如何套用自動產生的規則
在系統欄位上定義自訂規則的限制
您可以套用的不同自訂規則類型
評估規則的方式
針對繼承程式所定義的規則與內部部署 XML 進程之間的差異
為何您應該將您定義的自訂規則數目降到最低
在定義自訂規則之前，請閱讀設定和自訂Azure Boards ，以深入瞭解如何自訂Azure Boards以符合您的業務需求。
提示
將您為 WIT 定義的規則數目降到最低。 雖然您可以為 WIT 建立多個規則，但當使用者新增和修改工作專案時，新增規則可能會對效能造成負面影響。 當使用者儲存工作專案時，系統會驗證與其工作專案類型欄位相關聯的所有規則。 在某些情況下，規則驗證運算式太複雜，無法評估 SQL。
自動產生的規則
自動產生的規則可將應該以標準方式運作的區域新增自訂規則的需求降到最低。
狀態轉換規則
繼承的進程會針對每個自訂工作專案類型和新增至工作流程的自訂狀態，動態產生整個一組任意對任意狀態轉換規則。 從任何狀態轉換為任何狀態的有效狀態。
對於內部部署 XML 進程，您必須在工作專案類型定義的 區段中指定有效的轉換 WORKFLOW 。
狀態轉換和依/日期欄位規則
[依據/日期] 欄位會對應至 [建立者/日期 ]、[ 依日期啟動 ]、[ 依/日期解析 ] 和 [ 關閉日期 ]。
針對繼承的進程，當您將工作專案從某個狀態轉換為另一個狀態時，會自動設定或清除這些欄位。 [變更依據/日期] 欄位不會包含在內，因為它們會隨著每個工作專案儲存而更新，而且與狀態轉換無關。
管理這些欄位的預設規則和行為包括：
[已關閉 ] 狀態一律包含在 [已完成 ] 狀態類別中。[已完成 ] 狀態類別無法設定，且與一個和只有一個 State 相關聯。此 已關閉 狀態一律為敏捷式和 CMMI 程式 關閉 ，且一律為 Scrum 和基本程式 完成 。
這些規則的自動產生會受到地區設定的影響，因為規則條件包含已當地語系化的狀態名稱。 系統會針對不同的地區設定產生不同的規則。
這些欄位的自動產生規則只會針對包含這些欄位的工作專案類型指定。 工作專案類型可能不包含其中一或多個欄位。
當工作專案類型具有自訂狀態，或工作專案類型為自訂工作專案類型時，需要這些規則。
這些規則僅適用于繼承的進程;它們永遠不會針對裝載的 XML 或內部部署 XML 進程產生。
工作流程狀態會與狀態類別相關聯，以支援工作流程看板上的工作流程。 若要深入瞭解，請參閱待辦專案 和麵板如何使用工作流程狀態和狀態類別 。
狀態變更日期欄位規則
這些規則在技術上比關閉者/關閉日期規則簡單很多，因為它們不相依于任何特定狀態。 對於任何工作專案類型，相同的規則一律會運作。 它們必須自動產生，因為某些 OOB 工作專案類型不包含 [狀態變更日期] 欄位，因此當使用者將此欄位新增至自訂工作專案類型時，也必須自動產生這些規則。 這裡也適用于「關閉依據/關閉日期」規則的相同原則。
自訂規則
所有自訂規則都是選擇性的。 針對繼承的進程，您可以指定由條件加動作所組成的規則。 針對內部部署 XML 程式，您可以指定欄位或工作流程內的規則。
這兩個進程之間沒有一對一的對應。 在某些情況下，XML 元素規則是在繼承進程的 [ 編輯欄位 ] 對話方塊中定義，而不是規則。 繼承的進程不支援其他 XML 元素，例如 FROZEN 、 MATCHNOTSAMEAS 、 。
請注意：
規則一律會強制執行，而不只是當您與表單互動，也會在與其他工具互動時強制執行。 例如，將欄位設定為唯讀，不僅會在工作專案表單上套用規則，也會透過 API 和 Excel Azure DevOps Server增益集套用規則。
繼承的進程專案會指定條件和動作，以建立完整的規則。 XML 元素不會區分這些差異。
欄位規則不支援指派兩個其他欄位的總和或執行其他數學計算的值。 不過，您可以透過 TFS 匯總工具 (Web 服務) Marketplace 擴充功能，找到符合您需求的解決方案。 另請參閱 工作和其他欄位的匯總 。
您可能會發現使用 Marketplace 延伸模組將自訂規則套用至欄位的其他解決方案，例如 工作專案表單控制項程式庫延伸模組 。
規則組合
對於繼承的進程，每個規則都包含兩個部分：條件和動作。 條件會定義必須符合才能套用規則的情況。 動作會定義要執行的作業。 針對大部分的規則，您可以為每個規則指定最多兩個條件和 10 個動作。 所有自訂規則都需要符合所有條件才能執行。
例如，您可以根據指派給狀態的值和另一個欄位，建立必要的欄位。 例如：
(Condition) When a work item State isActive (Condition) And when the value of值區域 = 業務 (Action) Then make required劇本點
下表摘要說明所選 [條件] 中可用的動作。
隱藏欄位，或根據狀態和使用者或群組成員資格將欄位設為唯讀或必要
根據 和 使用者或群組成員資格，設定欄位屬性或限制狀態轉換
內部部署 XML 程式會使用 XML 元素定義規則。 所有這些規則元素都可以在工作專案類型定義的定義內 FIELD 定義。 除了 元素之外 HELPTEXT ，您可以指定這些規則在工作流程轉換期間生效，或指定為 (全域工作流程) 元素內的 FIELD 子項目。
注意
TFS 2018 和更新版本不支援元素 VALIDUSER 。
套用欄位規則的位置
當您想要將規則套用至工作專案整個生命週期的欄位時，請在 區段中指定它 FIELD 。 例如，如果某個欄位對於新的作用中 Bug 而言是必要欄位，在關閉 Bug 之前，這個欄位皆為必要欄位。 否則，如果您想要根據狀態、原因或轉換中的變更套用，請在 區段中指定它 WORKFLOW 。
State (System.State) 和 Reason (System.Reason) 欄位定義在 區 WORKFLOW 段中。 您可以指定在變更狀態、選取原因或特定轉換期間，將大多數欄位規則套用至欄位。 若要深入瞭解，請參閱 變更工作專案類型的工作流程 。
否則，請將規則指定為只在狀態變更期間才進行評估。 這些規則定義于 WORKFLOW 、 REASON 或 TRANSITION 元素下的 區段內 STATE 。 除了 以外的 HELPTEXT 所有規則，都可以在 (Workflow) 元素內 FIELD 套用。
欄位規則會加總。 也就是說，您可以為規則引擎評估的相同欄位指定四組規則。
不論工作專案在其狀態模型中的工作專案位置為何，工作專案類型特定 規則都會套用。 例如， <REQUIRED \> 規則會執行下列檢查：
"MyField Value" != NULL
當狀態處於特定狀態時，狀態特定 規則的範圍會限定為工作專案實例。 下列條件成立時，會強制執行特定狀態的規則：
State field value == "MyState" && "MyField Value" != NULL
您為特定轉換指定的轉換特定 規則會限定為正在進行特定轉換的工作專案。 下列條件成立時，會強制執行這些規則：
State field value == "ToState" &&"Previous State Before Edit/New" == "FromState"&& "MyField Value" != NULL
您針對特定原因指定的特定規則會 限定在特定轉換的特定原因。 下列條件成立時，會處理這些規則：
Reason field == "MyReason" &&State field value == "ToState" &&"Previous State Before Edit/New" == "FromState" && "MyField Value" != NULL
下列範例限制只有在工作項目處於「作用中」狀態時，才能修改客戶嚴重性欄位。
<STATE name="Active">
<FIELDS>
<FIELD refname="MyCorp.Severity" >
<READONLY />
</FIELD>
</FIELDS>
</STATE>
如果定義太多規則，會發生什麼事
每個專案都會定義單一 SQL 運算式，以在建立或更新工作專案時驗證工作專案。 此運算式會隨著您為專案定義之所有工作專案類型所指定的規則數目而成長。 針對欄位指定的每個行為限定詞，都會增加子運算式的數目。 巢狀規則、僅適用于轉換或條件設定為其他欄位值的規則，會導致將更多條件新增至 IF 語句。 一旦運算式達到特定大小或複雜度，SQL 就無法再評估它，並產生錯誤。 移除某些 WIT 或排除某些規則，可以解決錯誤。
您可以指定挑選清單 (下拉式功能表) 的值、設定預設值、清除項目，或限制變更。 使用條件式規則，您可以根據不同欄位值之間的相依性，將規則套用至欄位。 您也可以限制可修改欄位的人員，或將規則的範圍設為僅套用至群組。
工作專案規則不存在為單一集合。 這些規則實際上是以動態方式產生，並從不同的資料來源合併。 合併邏輯是簡單的規則，合併相同的規則，但不要修剪衝突的規則。
略過規則
一般而言，當使用者修改工作專案時，規則引擎會驗證所有工作專案。 不過，為了支援特定案例，獲派工作 專案更新專案層級許可權略過規則 的使用者，可以儲存工作專案，而不需要評估規則。
規則可以透過兩種方式之一略過。 第一個是透過 工作專案 - 更新 REST API ，並將 參數設定 bypassRules 為 true 。 第二個是透過用戶端物件模型，方法是在略過rules 模式中初始化 (WorkItemStore 初始化 WorkItemStoreFlags.BypassRules) 。
系統欄位和自訂規則
系統欄位具有 System。名稱 參考名稱，例如 System.Title 和 System.State 。
下列系統欄位必須具有值： 區域識別碼 、 變更日期 、 建立日期 、 建立日期 、 建立者、狀態 和 原因 。
規則引擎會將設定條件或動作限制為系統欄位，但如下所示：
您可以將 [狀態 ] 和 [ 原因] 欄位設為唯讀。
您可以將大部分規則套用至 [標題 ]、[ 指派給 ]、[ 描述 ] 和 [變更者] 欄位。
如果您在繼承程式的規則使用者介面的下拉式功能表中看不到列出的欄位，這就是原因。 例如，如果您嘗試根據條件 (System.AreaPath) 唯讀 ， 則 [區域路徑] 欄位不適用於選取範圍。 即使您能夠指定系統欄位，規則引擎仍可能會限制您儲存規則。
預設和複製規則
預設和複製規則會修改工作專案欄位的值。 他們會定義執行時間行為和條件約束，例如指定預設值、清除欄位、要求定義欄位等等。
大部分的規則動作都可以在任何條件選取的情況下套用。
Use the current time to set the value of ...
這些規則支援設定預設值、將值從一個欄位複製到另一個欄位，或強制欄位值符合指定的模式。 如需語法結構和範例，請參閱 定義預設值或將值複製到欄位 。
當使用者建立或修改工作項目時，將指定的值複製到欄位。
<FIELD refname="MyCorp.Status" name="Status" type="String">
<COPY from="value" value=" " />
</FIELD>
當使用者建立或修改工作項目時，為空白欄位指定值。 如果欄位已經有值，則會 DEFAULT 忽略規則。 只有在欄位的值目前為空白時 Is ，預設規則才會執行。 支援的值包括目前時間 () from = "clock" 、目前使用者 () from = "currentuser" 、常值值 (from = "value" value = "literal") ，或另一個欄位的值 (from = field field = "referenceNameField") 。
<FIELD refname="MyCorp.Priority" name="Priority" type="String"
<HELPTEXT>Specify the severity of the problem</HELPTEXT
<ALLOWEDVALUES
<LISTITEM value="P1"/
<LISTITEM value="P2"/
<LISTITEM value="P3"/
</ALLOWEDVALUES
<DEFAULT from="value" value="P3"/
</FIELD
指定要定義域值的伺服器時鐘或目前使用者。
<TRANSITION from="New" to="Active">
<ACTIONS>
<ACTION value="Microsoft.VSTS.Actions.StartWork" />
</ACTIONS>
<REASONS>
<DEFAULTREASON value="Work started" />
</REASONS>
<FIELDS>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
<COPY from="currentuser" />
<VALIDUSER />
<REQUIRED />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
<SERVERDEFAULT from="clock" />
</FIELD>
<FIELD refname="System.AssignedTo">
<DEFAULT from="currentuser" />
</FIELD>
</FIELDS>
</TRANSITION>
條件約束規則
條件約束規則會限制變更欄位的值。 他們會定義工作專案的有效狀態。 每個條件約束都會在單一欄位上運作。 條件約束會在工作專案儲存的伺服器上進行評估，如果違反任何條件約束，則會拒絕儲存作業。
大部分的規則動作都可以在任何條件選取的情況下套用。
Hide the field...只有在選取群組成員資格條件時，才能使用。
指定不要在工作專案表單上顯示欄位，基本上移除目前使用者變更域值的能力。
防止對欄位進行任何修改。 您可能想要在某些情況下套用這項規則。 例如關閉工作項目之後，您想要將欄位設為唯讀，以保留資料供報告之用。選項] 索引 標籤中指定 。
使用者必須指定欄位值。 使用者必須指派值給所有必要欄位，才能儲存工作項目。選項] 索引 標籤。
定義欄位的允許值清單。 允許的值是在工作項目表單和查詢產生器的欄位清單中可供選取的值。 您必須從這些值中選取一個。
防止使用者在指定值之後清除欄位的值。 這個項目會保存目前的欄位值，且無法清除或設為空白。
<FIELD refname="MyCorp.Priority" name="Management Priority" type="String">
<CANNOTLOSEVALUE />
</FIELD>
防止使用者在欄位包含值之後變更欄位的值。 一旦使用者以該欄位的值儲存工作項目之後，就無法再修改這個值。 在認可變更之後，已凍結的欄位就不能變更為任何非空白的值。 不過，您可以手動清除欄位、儲存工作項目，然後指定不同的值。
<FIELD refname="MyCorp.Priority" name="Management Priority" type="String">
<FROZEN not="[Project]\Management Team" />
</FIELD>
當使用者儲存工作項目時，會清除欄位所包含的任何值，然後使欄位變成唯讀。 您不應該搭配 READONLY 使用 EMPTY 。EMPTY 主要用於 狀態轉換期間 ，用來清除套用至專案轉換狀態的欄位。
<FIELD refname="MyCorp.SubStatus" />
<WHEN field="MyCorp.Status" value="Approve" >
<EMPTY />
</WHEN>
</FIELD>
強制對 String 欄位所做的專案符合 指定的字元或數位模式 。 如果您定義多個 MATCH 元素，如果值符合您指定的任何模式，就會被視為有效。 如果至少有一個項目成功，欄位就具有有效值。
<FIELD refname="MyCorp.GitHubURL" name="GitHub URL" type="String">
<MATCH pattern="https:\/\/github\.com\/\S+[\.md|\.yml]$"/>
</FIELD>
防止將指派給其他欄位的同一個值，指派給某個欄位。
<FIELD refname="MyCorp.Status" name="Status" type="String">
<NOTSAMEAS field="MyCorp.SubStatus" />
</FIELD>
定義欄位的禁用值清單。 如果多個 ALLOWEDVALUES 和/或 PROHIBITEDVALUES 規則套用至特定欄位，則有效值的完整清單是所有允許值清單的交集，或所有專案，如果沒有允許的值清單、減號，也就是設定差異—所有禁止值清單的聯集。
防止對欄位進行任何修改。 您可能想要在某些情況下套用這項規則。 例如關閉工作項目之後，您想要將欄位設為唯讀，以保留資料供報告之用。EMPTY 使用 READONLY ，因為 EMPTY 也會讓欄位變成隻讀。 結合這些專案可能會產生不一致的結果。ReadOnly 屬性，讓欄位從工作專案表單 Control 顯示為唯讀。 其他用戶端可以寫入這個欄位，但無法透過工作項目表單寫入。
<FIELD refname="MyCorp.Status" name="Status" type="String">
<READONLY />
</FIELD>
使用者必須指定欄位值。 使用者必須指派值給所有必要欄位，才能儲存工作項目。
<FIELD refname="MyCorp.Status" name="Status" type="String">
<REQUIRED />
</FIELD>
挑選清單
挑選清單會定義使用者可以或無法為 [字串] 或 [整數] 欄位選擇的值。 在挑選清單中定義的值會出現在工作項目表單和查詢編輯器中。
對於繼承的程式，挑選清單是透過 [編輯欄位] 對話方塊來定義。
定義欄位的允許值清單。 允許的值是在工作項目表單和查詢產生器的欄位清單中可供選取的值。 您必須從這些值中選取一個。
核取 [選項 ] 索引標籤內的[允許使用者輸入自己的值 ] 核取方塊，以允許使用者指定自己的專案
定義欄位的建議值清單。 建議的值是在工作項目表單和查詢產生器的欄位清單中可供選取的值。 除了清單中的值之外，您也可以輸入其他值。
您可以使用下表所列的 XML 元素來定義挑選清單。 如需語法結構和範例，請參閱 定義挑選清單 。
您可以合併清單，以及展開或摺疊清單。 此外，您也可以根據目前使用者的群組成員資格來限制這些規則的套用，如 使用者或群組成員資格規則限制 中所述。
定義欄位的允許值清單。 允許的值是在工作項目表單和查詢產生器的欄位清單中可供選取的值。 您必須從這些值中選取一個。
定義允許現有值的欄位。 這個項目允許使用已存在的欄位值 (即使這些值無效)。 所有新的欄位值都必須有效。
定義欄位的建議值清單。 建議的值是在工作項目表單和查詢產生器的欄位清單中可供選取的值。 除了清單中的值之外，您也可以輸入其他值。
身分識別欄位和驗證錯誤
若要避免成員離開小組且不再註冊為專案參與者時會發生的驗證錯誤，請包含 [指派給 ] 欄位的ALLOWEXISTINGVALUE 元素。
<FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension">
<HELPTEXT>The user who is working on this work item</HELPTEXT>
<ALLOWEXISTINGVALUE />
<VALIDUSER />
<ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
<LISTITEM value="Active" />
<LISTITEM value="[project]\Contributors" />
</ALLOWEDVALUES>
<DEFAULT from="field" field="System.CreatedBy" />
</FIELD>
條件域值或變更
條件式規則會根據等於或不等於特定值的域值，或變更為或未對特定欄位的值進行變更，來指定動作。 一般而言，條件式規則會先套用到無條件規則。 當多個條件式規則評估為 true 時，執行順序為：When、WhenNot、WhenChanged、WhenNotChanged。
您可以為每個欄位指定多個條件式規則。 但是，您只能為每個條件式規則指定一個驅動欄位。
The value of ... (equals) [When]
當其他欄位擁有特定值時，指定要套用到目前欄位的一個或多個規則。
A change was made to the value of ... [WhenChanged]
當特定欄位的值變更時，將一個或多個規則套用到目前的欄位。
The value of ... (not equals) [WhenNot]
當其他欄位沒有特定值時，將一個或多個規則套用到目前的欄位。
No change was made to the value of ... [WhenNotChanged]
當特定欄位的值沒有變更時，將一個或多個規則套用到目前的欄位。
Clear the value of ...Copy the value from ...Make read-only ...Make required ...Set the value of ...Use the current time to set the value of ...Use the current user to set the value of ...
下列 XML 元素可用來設定評估其他規則時的條件。 您可以為每個欄位指定多個條件式規則。 但是，您只能為每個條件式規則指定一個驅動欄位。 您無法巢狀條件式規則。 每個進程模型的支援動作都包含下表所列的動作。
如需語法結構和範例，請參閱 指派條件式值和規則 。 您可以根據目前使用者的群組成員資格來限制這些規則的套用，如 使用者或群組成員資格規則限制 中所述。
當其他欄位擁有特定值時，指定要套用到目前欄位的一個或多個規則。 父項目定義目前的欄位。
指定將一或多個規則套用至目前欄位時所依據的條件。 當其他欄位的值因為工作項目有所修訂而變更時，這些規則就會套用至目前的欄位。 父項目定義目前的欄位。
指定將一或多個規則套用至目前欄位時所依據的條件。 當其他欄位的值變更時，這些規則就會套用至目前的欄位。 父項目定義目前的欄位。
指定將一或多個規則套用至目前欄位時所依據的條件。 當其他欄位的值因為工作項目有所修訂而未變更時，這些規則就會套用至目前的欄位。 父項目定義目前的欄位。
使用者或群組成員資格規則限制
您可以根據目前使用者的成員資格來限制規則的應用程式。 我們建議您將規則的範圍設定為 Azure DevOps 安全性群組，而不是單一使用者，不過您可以指定後者。 若要將規則範圍設定為多個群組，您必須建立父 Azure DevOps 群組，其中包含您想要使用的群組集。
程式實作
提示
若要避免可能發生的規則評估問題，請指定 Azure DevOps 安全性群組，而不是 Azure Active Directory 或 Active Directory 安全性群組。 若要深入瞭解，請參閱 預設規則和規則引擎 。
如下表所示，若要根據目前使用者的成員資格限制規則，您可以指定繼承程式的兩個條件之一。 這些規則適用于 Azure DevOps 2020 和更新版本。
Current user is a member of group ...Current user is not member of group ...
Hide the field ...Make read-only ...Make required ...Restrict the transition to state ...
若要根據目前使用者的成員資格來限制規則，您可以在規則元素中指定 for 或 not 屬性。 您可以指定規則的範圍。 若要將規則範圍設定為多個群組，您必須建立父 Azure DevOps 群組，其中包含您想要使用的群組集。
使用 for 將規則套用至群組。 下列範例要求 Junior Analysts 群組中的所有使用者必須完成 [Second Approver] 欄位。
<FIELD name="Second Approver">
<REQUIRED for="Example1\Junior Analysts"/>
</FIELD>
使用 not 從規則中排除群組。 下列範例將 [Triage Description] 欄位定義為除了 Triage Committee 群組中的使用者之外，對於其他所有人均為唯讀。
<FIELD name="Triage Description">
<READONLY not="[Project]\Triage Committee" />
</FIELD>
使用 和 not 的組合 for ，同時將規則套用至某些規則，而不適用於其他規則。 下列範例將 [Severity] 定義為 Project Members 群組中使用者的必要欄位，但對於 Project Admins 群組中的使用者則非必要。 如果使用者位於這兩個群組中， for 則會強制執行 語句，而且需要欄位。
<FIELD name="Severity">
<REQUIRED for="[Project]\Project Members" not="[Global]\Project Admins"/>
</FIELD>
使用權杖來參考使用者或群組
身分識別或人員選擇器欄位可以接受參考使用者和群組的值。 當您將規則限制為群組時，會指出群組的網域或範圍。 對於某些值，您可以使用語彙基元。
權杖的範例包括：
[ProjectName ]，例如 [Fabrikam]、[FabrikamFiber]、[MyProject]
[OrganizationName ]， 例如 [fabrikam]， [myorganization]
[CollectionName ]， 例如 [fabrikam]， [myorganization]
若要瞭解專案或組織可用的範圍，請移至 [ 專案 > 設定許可權 > 群組 ] 或 [ 組織設定 > 許可權 > 群組 ] 頁面，您可以視需要篩選清單。 例如，下圖顯示根據 Azure DevOps 篩選清單的前四個專案。 若要深入瞭解，請參閱 變更專案層級許可權 或 變更專案集合層級許可權 。
權杖的範例包括：
[專案] ，例如 [Project]\參與者、[Project]\Fabrikam Team、[Project]\Project 核准者[專案] Token 指定為專案定義的群組。 這可以對應至小組、預設或自訂安全性群組，或已新增至專案的 Active Directory 群組。[GLOBAL] ，若要參考集合範圍群組，例如 [GLOBAL]\Project Collection Administrators 使用 [GLOBAL] 來參考集合範圍安全性群組，例如 Project Collection Administrators 群組或新增至集合的 Windows 群組。 例如：<FIELD name="Title">
<READONLY for="[GLOBAL]\Project Collection Valid Users"/>
</FIELD>
[Team Foundation] 參考伺服器範圍群組，例如 [Team Foundation]\Team Foundation 系統管理員使用 [Team Foundation] 來參考伺服器範圍群組，例如您新增至伺服器層級群組的內建群組或 Windows 群組。 例如：<FIELD name="Title">
<READONLY for="[Team Foundation]\Team Foundation Valid Users"/>
</FIELD>
[DomainName ] 參考伺服器範圍的群組，例如 [Team Foundation]\Team Foundation Administrators 網域限定帳戶名稱，例如下列範例所示的帳戶名稱，可用來參考網域使用者或群組。 某些規則僅支援群組，且不支援參考網域使用者。
<LISTITEM value="FABRIKAM\Christie Church's Direct Reports"/>
注意
[Project]、[GLOBAL]和 [Team Foundation] 會以原樣使用。 您不會將其取代為專案、集合或伺服器名稱的名稱。
若要瞭解專案或集合可用的範圍，請移至 [ 專案設定 > 許可權 > 群組 ] 或 [ 集合設定 > 許可權 > 群組 ] 頁面。 視需要篩選清單。 例如，下圖顯示根據 Azure DevOps 篩選清單的前四個專案。 若要深入瞭解，請參閱 變更專案層級許可權 或 變更專案集合層級許可權 。
所有使用者和群組都必須由上述其中一個語彙基元限定。 例如，下列 XML 無效，因為它不符合指定群組的有效權杖。
<FIELD name="Title">
<READONLY for="Dev Team"/>
</FIELD>
若要深入瞭解預設安全性群組，請參閱 許可權和群組
規則評估
根據修改工作專案之使用者或群組成員資格來指定條件的規則，會以兩種方式之一進行評估。 評估規則時，應用程式必須檢查該使用者是否為指定群組的成員，以判斷規則是否套用至目前使用者。
從入口網站、REST API 或 azure boards 命令修改工作專案時，會提出對 Azure Active Directory 或 Active Directory 的要求。 這項作業不會發生任何問題。
使用 WIT 用戶端物件模型從 Visual Studio、Excel 或其他自訂工具修改工作專案時，評估成員資格的要求是以用戶端快取為基礎。 用戶端快取不知道 Active Directory 群組。
注意
使用 GIT 之專案的 Visual Studio 2019 Team Explorer 已重新撰寫為使用 REST API。
若要避免使用者從各種用戶端更新工作專案時發生問題，請指定 Azure DevOps 安全性群組，而不是 Active Directory 群組。 您可以輕鬆地建立 Azure DevOps 安全性群組，以對應至 Active Directory 群組。 若要深入瞭解，請參閱 新增或移除使用者或群組、管理安全性群組 。
注意
WIT 用戶端 OM 已被取代。 自 2020 年 1 月 1 日起，在處理 Azure DevOps Services 和 Azure DevOps Server 2020 時不再支援。
評估規則的順序
規則通常會在列出規則的順序中處理。 不過，所有規則評估的完整順序並不具決定性。
本節描述當您套用條件式、複製和預設規則時的預期行為和互動。
下列步驟會以正確的順序顯示 Azure DevOps 所執行的互動，以及工作專案表單的使用者。 只有步驟 1、8 和 13 由使用者執行。
從 Azure DevOps 用戶端，例如入口網站或 Visual Studio Team Explorer，使用者會建立新的工作專案或編輯現有的工作專案。
填入欄位預設值。 針對所有欄位，套用指派給不屬於條件子句之欄位的任何預設值。
複製或設定域值。 針對所有欄位，套用任何規則來複製值，或設定不屬於條件子句一部分的域值。
針對符合 [條件式規則] 的所有欄位，套用規則來設定或複製域值。
對於符合 [當非條件式規則] 的所有欄位，請套用規則來設定或複製域值。
系統一律會在 [未使用時 ] 規則之前處理[ 何時] 規則。
對於自步驟 1 起變更其值的所有欄位，以及包含 變更 規則的所有欄位，請套用規則來設定或複製域值。
允許使用者開始編輯。
使用者變更欄位值，然後將焦點移出欄位。
處理符合新值之欄位的任何 When 規則。
處理符合新值之欄位的任何 When Not 規則。
處理符合新值之欄位的任何 [變更時 ] 規則。
將編輯能力歸還給使用者。
使用者會將變更儲存至資料存放區。
針對所有欄位，套用針對條件式規則直接或間接定義欄位的任何 Use the current time to set the value of ... 動作。
規則通常會在列出規則的順序中處理。 不過，當您使用 WHEN、DEFAULT 和COPY 元素時 ，可能會套用其他行為。 下列步驟會以正確的順序顯示 Azure DevOps 所執行的互動，以及工作專案表單的使用者。 只有步驟 1、8 和 13 由使用者執行。
從 Azure DevOps 用戶端，例如入口網站或 Visual Studio Team Explorer，使用者會建立新的工作專案或編輯現有的工作專案。
填入欄位預設值。 針對所有欄位，套用在外部或WHEN 規則以外的任何DEFAULT 規則。
複製欄位值。 針對所有欄位，請使用WHEN 子句以外的任何COPY 規則。
對於符合 WHEN 規則的所有欄位，請先執行 DEFAULT 和 COPY 規則。
對於符合 WHENNOT 規則的所有欄位，請先執行 DEFAULT 和 COPY 規則。
系統一律會在WHENNOT 規則之前處理WHEN 規則。
對於自步驟 1 起變更其值且包含 WHENCHANGED 規則的所有欄位，請先執行 DEFAULT 和 COPY 規則。
允許使用者開始編輯。
使用者變更欄位值，然後將焦點移出欄位。
針對符合新值之欄位引發任何 WHEN 規則。
針對符合新值之欄位引發任何 WHENNOT 規則。
針對符合新值之欄位引發任何 WHENCHANGED 規則。
將編輯能力歸還給使用者。
使用者會將變更儲存至資料庫。
針對所有欄位，請針對WHEN 或 WHENNOT 規則直接或間接定義欄位的SERVERDEFAULT 作業。
按鍵專案和規則評估
每次使用者透過工作專案表單在欄位中輸入按鍵時，系統會設定欄位的新值。 這表示每當符合規則的必要條件時，條件式規則可能會意外發生。
在下列 XML 範例中，系統會在 [狀態] 欄位中輸入 「Approved Again」 時清除 MyCorp.SubStatus，因為當使用者在 [核准] 中輸入字母 「e」 時，就會立即發生 WHEN 規則，即使預期的最終值不是 「Approv」。 因此，當您使用條件式規則時，請謹慎考量。
<FIELD refname="MyCorp.SubStatus" />
<WHEN field="MyCorp.Status" value="Approve" >
<EMPTY />
</WHEN>
</FIELD>
相關文章
