使用 WHEN、WHENNOT 和 WHENCHANGED 条件

可以使用 WHEN、WHENNOT、WHENCHANGED 和 WHENNOTCHANGED 元素来定义按条件运行的规则。这些规则定义当所定义的子句为 True 时将运行哪些元素。例如，您可以创建相关选取列表以提供详细的安全性或自定义行为。下面是一个简单的 WHEN 子句示例：

<FIELD . . . >

    <WHEN field="refname" value="yyy">

</FIELD>

此子句表示，只要字段 refname 具有值“yyy”，则此 FIELD 元素中的任何内容都将适用。该字段必须为有效的字段引用名称。有关更多信息，请参见字段引用名。

注意

value 属性不区分大小写。所以，如果字段 refname 存储的值为“YYY”，则匹配将包括 value =“yyy”或“YYY”的所有项。

示例

相关选取列表

下面的示例演示一个相关选取列表，在该列表中 Problem Type 的允许值受 ProblemCharacteristic 的值的限制：

复制

<FIELD refname="MyCorp.ProblemType" name="Problem Type" type="String">
    <WHEN field="MyCorp.ProblemCharacteristic" value="Documentation">
        <ALLOWEDVALUES>
            <LISTITEM value="Spelling Error" />
            <LISTITEM value="Bad Format" />
            <LISTITEM value="Missing Info" />
        </ALLOWEDVALUES>
    </WHEN>
</FIELD>

必填字段

下面的示例演示了必填字段中的一个更改。在此情况中，当客户报告一个 Bug 时，必须输入客户严重级别。如果客户没有报告 Bug，则不需要输入客户严重级别。

WHEN

<WHEN>

示例

复制

<FIELD refname="MyCorp.Severity" name="Customer Severity" type="String">
    <ALLOWEDVALUES>
        <LISTITEM value="Blocking" />
        <LISTITEM value="Major" />
        <LISTITEM value="Minor" />
    </ALLOWEDVALUES>
    <WHEN field="MyCorp.CustomerReported" value="true">
        <REQUIRED />
    </WHEN>
</FIELD>

条件   只要字段 Customer Reported 具有值且该值为 true，则此元素中的任何内容都将适用。

WHENNOT

<WHENNOT>

示例

复制

<WHENNOT field="refname" value="yyy">
</WHENNOT>

条件   只要字段 refname 具有值且该值不为 yyy，则此元素中的任何内容都将适用。

WHENCHANGED

<WHENCHANGED>

示例

复制

<FIELD refname="MyCorp.StateDate" name="Date Of Last State Change" type="DateTime">
    <WHENCHANGED field="MyCorp.State">
        <COPY from="clock" />
    </WHENCHANGED>
</FIELD>
<!-- Clear the status field whenever someone changes the state -->
<FIELD refname="MyCorp.Status" name="Status" type="String">
    <WHENCHANGED field="MyCorp.State">
        <COPY from="value" value="">
    </WHENCHANGED>
</FIELD>

条件   当用户修改了字段 refname 时，此元素中的任何内容都将适用。

WHENNOTCHANGED

<WHENNOTCHANGED>

示例

复制

<FIELD refname="MyCorp.StateDate" name="Date Of Last State Change" type="DateTime">
<!-- Make the State field readonly when the StateDate field is not changed -->
    <WHENNOTCHANGED field="MyCorp.State">
        <READONLY />
    </WHENNOTCHANGED>
</FIELD>

条件   只要字段 refname 不更改，此元素中的任何内容都将适用。