可用的字段規則

字段規則定義字段上的行爲和約束。字段規則是 <FIELD></FIELD> 塊內所列的附加元素。例如,如果某個字段是必需字段,則定義該字段的 XML 可能類似下面這樣:

<FIELD refname="System.Priority" name="Priority" type="String">
<HELPTTEXT>Enter the business priority of the bug</HELPTEXT>
<REQUIRED />
</FIELD>

可用的字段規則

可以使用以下字段規則來更改字段的行爲:

<REQUIRED />

此字段不能爲空。可以將任何字段類型標記爲必需字段。此元素接受 fornot 屬性。有關更多信息,請參見 REQUIRED 元素(工作項類型定義架構)

<READONLY />

此字段不能修改。此元素接受 fornot 屬性。有關更多信息,請參見 READONLY 元素(工作項類型定義架構)

<EMPTY />

字段值在提交時被清除,且用戶不能輸入任何值。此規則主要在狀態轉換期間用來清除應用於轉換到的狀態的字段。此元素接受 fornot 屬性。有關更多信息,請參見 EMPTY 元素(工作項類型定義架構)

<FROZEN/>

一旦字段在提交之後具有了某個值,該值即不能再修改。但是,可以使用 <EMPTY/> 約束來清除此字段。用戶可以手動清除此字段,保存工作項,然後在重新加載時另外指定一個值。此元素接受 fornot 屬性。有關更多信息,請參見 FROZEN 元素(工作項類型定義架構)

<CANNOTLOSEVALUE/>

字段獲取值之後,便無法清除該字段或將其留空。此元素接受 fornot 屬性。有關更多信息,請參見 CANNOTLOSEVALUE 元素(工作項類型定義架構)

<NOTSAMEAS field="MyCorp.Reviewer" />

字段值不能與其他字段具有相同的值;在本例中爲“MyCorp.Reviewer”字段。字段值必須是有效的字段引用名。有關更多信息,請參見 字段引用名

使用 NOTSAMEAS 字段規則的示例:

  • 兩個字段不能同時爲空。

  • “代碼審閱者”字段值不能與“指派給”字段值相同。

對於相似類型的字段使用此規則。不能將此規則用於 PlainText 或 HTML 字段。此元素接受 fornot 屬性。有關更多信息,請參見 NOTSAMEAS 元素(工作項類型定義架構)

<VALIDUSER group="group" />

字段值必須是作爲“Team Foundation Valid Users”組成員的有效用戶。

此規則支持可選的組屬性,用於指定用戶必須是指定組的直接成員或間接成員。默認情況下,此規則允許作爲“Team Foundation Valid Users”組成員的所有用戶。有關更多信息,請參見 用標記引用用戶和組。此元素接受 fornot 屬性。有關更多信息,請參見 VALIDUSER 元素(工作項類型定義架構)

Note注意

如果未指定 <REQUIRED/> 規則,此字段將接受空值。用於 String 字段類型。

Note注意

工作項字段不區分不同域中的用戶標識。因此,在使用 <VALIDUSER /> 規則的字段中輸入的“Example1/jaepak”和“Example2/jaepak”將被視爲同一個用戶。但是,Team Foundation Server 中其他位置會區分不同域的用戶標識。

<ALLOWEXISTINGVALUE/>

允許字段保留現有值,即使該值已不再啓用。與此相對的默認行爲是強制用戶在編輯時匹配該字段的最新啓用的值。此元素僅對同一個塊中的元素具有修改效果。此元素不能接受 fornot 屬性。有關更多信息,請參見 ALLOWEXISTINGVALUE 元素(工作項類型定義架構)

<ALLOWEDVALUES/>

一個值的枚舉列表,以列表的形式呈現給用戶。用戶必須選擇該列表上的一個值。此元素接受 fornot 屬性。有關更多信息,請參見 ALLOWEDVALUES 元素(工作項類型定義架構)

<SUGGESTEDVALUES/>

一個值的枚舉列表,以列表的形式呈現給用戶。用戶可以選擇其中任何一個值。用戶還可以輸入自己的非建議值。此元素接受 fornot 屬性。有關更多信息,請參見 SUGGESTEDVALUES 元素(工作項類型定義架構)

<PROHIBITEDVALUES/>

如果字段包含任何禁止的值,則用戶不能保存工作項。在某個值以前曾被允許但現在不再有效時,通常使用禁止的值。此元素接受 fornot 屬性。有關更多信息,請參見 PROHIBITEDVALUES 元素(工作項類型定義架構)

<DEFAULT>

用戶創建新的工作項或編輯工作項時,如果字段爲空,<DEFAULT> 元素將填寫一個字段值。如果字段已具有值,則忽略默認規則。此元素接受 fornot 屬性。有關更多信息,請參見 DEFAULT 元素(工作項類型定義架構)

Note注意

更改工作項時,關於是選擇另一個字段的當前值還是該字段以前的值,此元素規則是不確定的。

<COPY>

用戶創建新的工作項或更改工作項時,無論字段中是否已存在任何值,<COPY> 元素都會填寫一個字段值。此元素接受 fornot 屬性。有關更多信息,請參見 COPY 元素(工作項類型定義架構)

Note注意

更改工作項時,關於是選擇另一個字段的當前值還是該字段以前的值,此元素規則是不確定的。

<SERVERDEFAULT>

與 <DEFAULT> 和 <COPY> 在開始編輯時填寫值不同,<SERVERDEFAULT> 規則在向數據庫提交工作項時填寫值。此操作發生在保存時,且用戶無法重寫該值。此類字段在窗體中以只讀的形式顯示。此規則用於“上次更改者”和“上次更改日期”等字段,以支持安全的審覈記錄。此元素接受 fornot 屬性。有關更多信息,請參見 SERVERDEFAULT 元素(工作項類型定義架構)

<MATCH pattern="<pattern>"/>

僅強制對字符串進行基本模式匹配。<pattern> 應替換爲匹配模式。有效值爲“A”、“N”和“X”。所有其他值作爲原義字符使用。“A”代表字母字符。“N”代表數字字符。“X”代表任何字母數字字符。只有 String 類型字段支持此模式。此元素接受 fornot 屬性。有關更多信息,請參見 MATCH 元素(工作項類型定義架構)

模式匹配示例

下面的示例闡釋各種字段用法的成功的和失敗的模式匹配:

發佈號

模式:ANN.NN.NN

通過驗證

R01.03.04 或 V05.08.99

未通過驗證

1.3.4 或 V5.8.99 或 v1.3

靈活的標識符

模式:XXX-XXX

通過驗證

001-abc 或 a00-b02

未通過驗證

1-abc 或 001.abc

優先級

模式:PN

通過驗證

P1 或 P5 或 P9

未通過驗證

1 或 P10

匹配標記是不區分大小寫的,因此“PN”同時匹配 P1 和 p1。

Note注意

可以指定多個 <MATCH> 元素。如果至少有一個元素成功,則字段具有有效值。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章