将规则添加到自适应表单

概述

规则编辑器功能使表单业务用户和开发人员能够编写关于自适应表单对象的规则。 这些规则根据预设条件、用户输入和用户对表单的操作，定义要在表单对象上触发的操作。 它有助于进一步简化表单填写体验，确保准确性和速度。

规则编辑器提供了直观、简化的用户界面来编写规则。 规则编辑器为所有用户提供了一个可视编辑器。 可使用规则对自适应表单对象执行的一些关键操作包括：

• 显示或隐藏对象
• 启用或禁用对象
• 设置对象的值
• 验证对象的值
• 执行函数以计算对象的值
• 调用表单数据模型服务并执行操作
• 设置对象的属性

添加到forms-power-users组的用户可以创建脚本并编辑现有脚本。 中的用户 forms-users 组可以使用脚本，但不能创建或编辑脚本。

了解规则

规则是操作和条件的组合。 在规则编辑器中，操作包括隐藏、显示、启用、禁用或计算表单中对象值等活动。 条件是对表单对象的状态、值或属性执行检查和操作来求值的布尔表达式。 根据值( True 或 False)返回的结果。

规则编辑器提供了一组预定义的规则类型（如When、Show、Hide、Enable、Disable、Set Value Of和Validate）以帮助您编写规则。 每种规则类型都允许您定义规则中的条件和操作。 本文档进一步详细说明了每种规则类型。

规则通常遵循以下结构之一：

Condition-Action 在此构造中，规则首先定义条件，然后定义要触发的操作。 这个构造可以类比于编程语言中的if-then语句。

在规则编辑器中， 时间 规则类型强制实施condition-action构造。

操作条件 在此构造中，规则首先定义要触发的操作，然后定义求值的条件。 此构造的另一个变体是action-condition-alternate action，它还在条件返回False时定义要触发的替代操作。

规则编辑器中的“显示”、“隐藏”、“启用”、“禁用”、“设置值”和“验证”规则类型强制实施操作条件规则结构。 默认情况下，“显示”的替代操作是“隐藏”，“启用”的替代操作是“禁用”，反之亦然。 您不能更改默认替代操作。

有关规则编辑器中可用的规则类型的更多信息，请参阅 规则编辑器中的可用规则类型.

选择规则结构的准则

虽然您可以使用任何规则构建来实现大多数用例，但以下是选择一种构建而不是另一种构建的一些准则。 有关规则编辑器中可用规则的更多信息，请参阅 规则编辑器中的可用规则类型.

• 创建规则时，一个典型的经验法则是在您编写规则的对象的上下文中考虑它。 假定您要根据用户在字段A中指定的值隐藏或显示字段B。在这种情况下，您将评估字段A的条件，并根据它返回的值，触发对字段B的操作。

  因此，如果您在字段B（评估条件的对象）上编写规则，请使用condition-action结构或When规则类型。 同样，在字段A上使用操作条件结构或显示或隐藏规则类型。

• 有时，必须根据一个条件执行多个操作。 在这种情况下，建议使用condition-action构造。 在此构造中，您可以计算一个条件一次，并指定多个操作语句。

  例如，要根据检查用户在字段A中指定的值的条件隐藏字段B、C和D，请编写一条规则，其中具有条件 — 操作结构或字段A上的规则类型When，并指定操作以控制字段B、C和D的可见性。否则，您需要对字段B、C和D使用三个单独的规则，其中每个规则检查条件并显示或隐藏各自的字段。 在此示例中，在一个对象上编写When规则类型比在三个对象上编写Show或Hide规则类型更有效。

• 要根据多个条件触发操作，建议使用action-condition构造。 例如，要通过评估字段B、C和D的条件来显示和隐藏字段A，请在字段A中使用显示或隐藏规则类型。

• 如果规则中包含适用于一个条件的一个操作，请使用条件 — 操作或操作条件构造。

• 如果规则检查条件，并在字段中提供值或退出字段时立即执行操作，建议在评估条件的字段中编写具有condition-action构造或When规则类型的规则。

• 当用户更改应用了时间规则的对象的值时，将评估When规则中的条件。 但是，如果您希望操作在服务器端更改时触发（如预填充值），建议编写一个When规则，以在字段初始化时触发操作。

• 在编写下拉列表、单选按钮或复选框对象的规则时，表单中这些表单对象的选项或值会预填充到规则编辑器中。

规则编辑器中的可用运算符类型和事件

规则编辑器提供了以下逻辑运算符和事件，您可以使用这些运算符和事件创建规则。

• 等于
• 不等于
• 开头为
• 结束于
• 包含
• 为空
• 不为空
• 已选择： 当用户为复选框、下拉菜单单选按钮选择特定选项时，返回true。
• 已初始化（事件）： 在浏览器中呈现表单对象时返回true。
• 已更改（事件）： 当用户更改表单对象的输入值或选定选项时，返回true。
• 导航（事件）： 当用户单击导航对象时返回true。 导航对象用于在面板之间移动。
• 步骤完成（事件）： 完成规则的步骤时返回true。
• 提交成功（事件）： 成功将数据提交到表单数据模型时返回true。
• Submission(event)出错： 向表单数据模型提交数据失败时返回true。

规则编辑器中的可用规则类型

规则编辑器提供了一组可用于编写规则的预定义规则类型。 让我们详细了解一下每种规则类型。 有关在规则编辑器中编写规则的更多信息，请参阅 写入规则.

时间

此 时间 规则类型遵循 condition-action-alternate action 规则结构，或者有时只是 condition-action 构造。 在此规则类型中，您首先为求值指定条件，然后指定满足该条件时要触发的操作( True)。 使用When规则类型时，您可以使用多个AND和OR运算符来创建 嵌套表达式.

使用When规则类型，您可以评估表单对象的条件，并对一个或多个对象执行操作。

简单地说，典型的When规则的结构如下：

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

对对象B采取行动2；对对象C采取行动3；

_

当具有多值组件（如单选按钮或列表）时，为该组件创建规则时将自动检索选项并使这些选项可用于规则创建者。 您无需再次键入选项值。

例如，列表有四个选项：红色、蓝色、绿色和黄色。 创建规则时，将自动检索选项（单选按钮）并使规则创建者可以使用此选项，如下所示：

编写When规则时，您可以触发Clear Value Of操作。 清除值操作清除指定对象的值。 通过在When语句中将清除值设置为选项，可以创建具有多个字段的复杂条件。

隐藏 隐藏指定的对象。

显示 显示指定的对象。

启用 启用指定的对象。

禁用 禁用指定的对象。

调用服务 调用在表单数据模型中配置的服务。 选择“调用服务”操作时，将显示一个字段。 点按该字段，它会显示您在上的所有表单数据模型中配置的所有服务。 Experience Manager 实例。 在选择表单数据模型服务时，会显示更多字段，您可以在其中使用指定服务的输入和输出参数映射表单对象。 请参阅调用表单数据模型服务的示例规则。

除了表单数据模型服务之外，您还可以指定直接WSDL URL来调用Web服务。 但是，表单数据模型服务具有许多好处，并且推荐了调用服务的方法。

有关在表单数据模型中配置服务的更多信息，请参阅 Experience Manager Forms 数据集成.

设置值 计算并设置指定对象的值。 您可以将对象值设置为字符串、另一个对象的值、使用数学表达式或函数的计算值、对象的属性值或来自已配置表单数据模型服务的输出值。 选择Web服务选项后，它将显示在上的所有表单数据模型中配置的所有服务。 Experience Manager 实例。 在选择表单数据模型服务时，会显示更多字段，您可以在其中使用指定服务的输入和输出参数映射表单对象。

有关在表单数据模型中配置服务的更多信息，请参阅 Experience Manager Forms 数据集成.

此 设置属性 规则类型允许您根据条件操作设置指定对象的属性值。

它使您能够定义规则以动态地将复选框添加到自适应表单。 您可以使用自定义函数、表单对象或对象属性来定义规则。

要根据自定义函数定义规则，请选择 函数输出 ，然后从下拉列表中拖放自定义函数 函数 选项卡。 如果满足条件操作，则自定义函数中定义的复选框数将添加到自适应表单中。

要根据表单对象定义规则，请选择 表单对象 从下拉列表中，拖放表单对象 表单对象 选项卡。 如果满足条件操作，则表单对象中定义的复选框数将添加到自适应表单。

通过基于对象属性的设置属性规则，可根据自适应表单中包含的其他对象属性在自适应表单中添加复选框的数量。

下图描述了一个基于自适应表单中的下拉列表数量动态添加复选框的示例：

清除值 清除指定对象的值。

设置焦点 将焦点设置为指定的对象。

保存表单 保存表单。

提交Forms 提交表单。

重置表单 重置表单。

验证表单 验证表单。

添加实例 添加指定可重复面板或表行的实例。

删除实例 删除指定可重复面板或表行的实例。

导航到 导航到其他 自适应Forms、图像或文档片段等其他资源或外部URL。

设置值

此 设置值 规则类型允许您根据是否满足指定的条件来设置表单对象的值。 该值可以设置为另一个对象的值、文本字符串、从数学表达式或函数派生的值、另一个对象的属性值或表单数据模型服务的输出。 同样，您可以检查组件、字符串、属性或从函数或数学表达式派生的值的条件。

此 设置值 规则类型不适用于所有表单对象，例如面板和工具栏按钮。 标准“设置值”规则具有以下结构：

将对象A的值设置为：

（字符串ABC） OR（对象C的对象属性X） OR（函数的值） OR（数学表达式的值） OR（数据模型服务或Web服务的输出值）；

时间（可选）：

（条件1、条件2和条件3）为TRUE；

以下示例将值引入 dependentid 字段作为输入，并设置 Relation 字段到的输出 Relation 的参数 getDependent 表单数据模型服务。

使用表单数据模型服务的设置值规则示例

显示

使用 显示 规则类型，您可以根据是否满足条件来编写显示或隐藏表单对象的规则。 Show rule类型也会在条件不满足或返回时触发Hide操作 False.

典型的Show规则的结构如下：

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

隐藏

与显示规则类型类似，您可以使用 隐藏 规则类型，根据是否满足条件来显示或隐藏表单对象。 Hide规则类型还会触发Show操作，以防条件未得到满足或返回 False.

典型的“隐藏”规则的结构如下所示：

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

启用

此 启用 规则类型允许您根据是否满足条件来启用或禁用表单对象。 Enable规则类型还会触发Disable操作，以防条件未得到满足或返回 False.

典型的Enable规则的结构如下所示：

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

禁用

与启用规则类型类似， 禁用 规则类型允许您根据是否满足条件来启用或禁用表单对象。 Disable规则类型还会触发Enable操作，以防条件不满足或返回 False.

典型的禁用规则的结构如下：

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

验证

此 验证 规则类型使用表达式验证字段中的值。 例如，您可以编写一个表达式，以检查用于指定名称的文本框是否不包含特殊字符或数字。

典型的验证规则的结构如下所示：

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

设置选项

此 设置选项 规则类型允许您定义规则以动态地将复选框添加到自适应表单。 您可以使用表单数据模型或自定义函数来定义规则。

要根据自定义函数定义规则，请选择 函数输出 ，然后从下拉列表中拖放自定义函数 函数 选项卡。 自定义函数中定义的复选框数会添加到自适应表单中。

要创建自定义函数，请参见 规则编辑器中的自定义函数.

要根据表单数据模型定义规则，请执行以下操作：

1. 选择 服务输出 下拉列表中。
2. 选择数据模型对象。
3. 从中选择数据模型对象属性 显示值 下拉列表。 自适应表单中的复选框数是从数据库中为该属性定义的实例数派生而来的。
4. 从中选择数据模型对象属性 保存值 下拉列表。

了解规则编辑器用户界面

规则编辑器提供了一个全面而简单的用户界面来编写和管理规则。 您可以在创作模式下从自适应表单中启动规则编辑器用户界面。

要启动规则编辑器用户界面，请执行以下操作：

1. 在创作模式下打开自适应表单。

2. 点按要为其编写规则的表单对象，然后在组件工具栏中点按 . 此时将显示规则编辑器用户界面。

   

   此视图中列出了选定表单对象上的任何现有规则。 有关管理现有规则的信息，请参见 管理规则.

3. 点按 创建 编写新规则。 首次启动规则编辑器时，会默认打开规则编辑器用户界面的可视化编辑器。

   

让我们详细了解规则编辑器UI的每个组件。

A.组件规则显示

显示自适应表单对象的标题（通过自适应表单对象启动规则编辑器）和当前选定的规则类型。 在上述示例中，规则编辑器是从名为Salary的自适应表单对象启动的，并且选定的规则类型是When。

B.表单对象和功能

规则编辑器用户界面左侧的窗格包含两个选项卡： Forms对象 和 函数.

“表单对象”选项卡显示自适应表单中包含的所有对象的分层视图。 它显示对象的标题和类型。 在编写规则时，可以将表单对象拖放到规则编辑器中。 在将对象或函数拖放到占位符中时，创建或编辑规则时，占位符会自动采用相应的值类型。

应用了一个或多个有效规则的表单对象将标有绿点。 如果应用于表单对象的任何规则无效，则表单对象将标有一个黄点。

“函数”选项卡包含一组内置函数，例如“总和”、“最小值”、“最大值”、“平均值”、“数目”和“验证表单”。 您可以使用这些函数计算可重复面板和表行中的值，并在编写规则时在操作和条件语句中使用它们。 但是，您可以创建 自定义函数 也是。

在表单对象的左侧树中，您可以点按表单对象以显示应用于每个对象的规则。 您不仅可以浏览各种表单对象的规则，还可以复制粘贴表单对象之间的规则。 有关更多信息，请参阅 复制粘贴规则.

C.表单对象和函数切换

点按切换按钮可切换表单对象和函数窗格。

D.可视规则编辑器

可视规则编辑器是规则编辑器用户界面的可视编辑器模式中用于编写规则的区域。 它允许您选择规则类型并相应地定义条件和操作。 在规则中定义条件和操作时，您可以从表单对象和函数窗格中拖放表单对象和函数。

有关使用可视规则编辑器的更多信息，请参见 写入规则.

E.完成和取消按钮

此 完成 按钮用于保存规则。 您可以保存不完整的规则。 但是，不完整无效，不执行。 当您下次从同一表单对象启动规则编辑器时，会列出表单对象上保存的规则。 您可以在该视图中管理现有规则。 有关更多信息，请参阅 管理规则.

此 取消 按钮会放弃对规则所做的任何更改并关闭规则编辑器。

写入规则

您可以使用可视规则编辑器编写规则 <!> — 或代码编辑器>。 首次启动规则编辑器时，它将在可视编辑器模式下打开。 您可以切换到代码编辑器模式并编写规则。 但是，如果在代码编辑器中编写或修改规则，则除非清除代码编辑器，否则无法切换到该规则的可视化编辑器。 当您下次启动规则编辑器时，它将在您上次用于创建规则的模式下打开。

让我们首先看一下如何使用可视编辑器编写规则。

使用可视编辑器

让我们了解如何使用以下示例表单在可视编辑器中创建规则。

示例贷款申请表中的“贷款要求”部分要求申请人指定其婚姻状况、工资以及配偶的工资（如果已婚）。 根据用户输入，规则将计算贷款资格金额，并显示在贷款资格字段中。 应用以下规则来实施方案：

• 配偶的“薪金”字段仅在婚姻状况为已婚时显示。
• 贷款资格金额为工资总额的50%。

要编写规则，请执行以下步骤：

1. 首先，根据用户为“婚姻状况”单选按钮选择的选项，编写规则以控制“配偶薪金”字段的可见性。

   在创作模式下打开贷款申请表单。 点按 婚姻状况 组件和点按 . 下一步，点按 创建 以启动规则编辑器。

   

   在启动规则编辑器时，默认情况下会选中When规则。 此外，启动规则编辑器的表单对象（在本例中为“婚姻状况”）在When语句中指定。

   虽然不能更改或修改所选对象，但可以使用如下所示的规则下拉列表选择其他规则类型。 如果要在其他对象上创建规则，请点按取消以退出规则编辑器，然后从所需的表单对象中再次启动该编辑器。

2. 点按 选择状态 下拉菜单并选择 等于. 此 输入字符串 字段。

   

   在“婚姻状况”单选按钮中， 已婚 和 单身 已分配选项 0 和 1 个值。 您可以在“编辑”单选按钮对话框的“标题”选项卡中验证分配的值，如下所示。

   

3. 在 输入字符串 字段中，指定 0.

   

   您已将条件定义为 When Marital Status is equal to Married. 接下来，定义在此条件为True时要执行的操作。

4. 在Then语句中，选择 显示 从 选择操作 下拉菜单。

   

5. 拖放 配偶薪金 字段。 拖放对象或在此选择 字段。 或者，点按 拖放对象或在此选择 字段并选择 配偶薪金 字段，其中列出了表单中的所有表单对象。

   

   规则编辑器中的规则如下所示。

   

6. 点按 完成 以保存规则。

7. 重复步骤1至5，定义另一个规则，以隐藏“配偶薪金”字段（如果婚姻状况为“单身”）。 规则编辑器中的规则如下所示。

   

   注意

   或者，您可以在“配偶薪金”字段编写一个“显示”规则，而不是“婚姻状况”字段编写两个“当规则”，以实施相同的行为。

   

8. 接下来，编写规则以计算贷款资格金额（占总薪金的50%），并在“贷款资格”字段中显示。 要实现此结果，请创建 设置值 “贷款资格”字段规则。

   在创作模式下，点按 贷款资格 字段并点按 . 下一步，点按 创建 以启动规则编辑器。

9. 选择 设置值 规则。

   

10. 点按 选择选项 并选择 数学表达式. 用于编写数学表达式的字段打开。

    

11. 在表达式字段中：

    • 从Forms对象选项卡中选择或拖放 薪金 第一个字段中的字段 拖放对象或在此选择 字段。

    • 选择 加号 从 选择运算符 字段。

    • 从Forms对象选项卡中选择或拖放 配偶薪金 字段中的其他字段 拖放对象或在此选择 字段。

    

12. 接下来，点按表达式字段周围高亮显示的区域，然后点按 扩展表达式.

    

    在扩展表达式字段中，选择 除以 从 选择运算符 字段和 数字 从 选择选项 字段。 然后，指定 2 在数字字段中。

    

    注意

    可以使用“选择选项”字段中的组件、函数、数学表达式和属性值来创建复杂表达式。

    接下来，创建一个条件，当该条件返回True时，表达式将执行。

13. 点按 添加条件 添加When语句。

    

    在When语句中：

    • 从Forms对象选项卡中选择或拖放 婚姻状况 第一个字段中的字段 拖放对象或在此选择 字段。

    • 选择 等于 从 选择运算符 字段。

    • 选择另一个中的字符串 拖放对象或在此选择 字段并指定 已婚 在 输入字符串 字段。

    规则编辑器中的规则最终如下所示。

14. 点按 完成. 它保存规则。

15. 重复步骤7至14，定义另一条规则，以计算婚姻状况为“单身”时的贷款资格。 规则编辑器中的规则如下所示。

    

规则编辑器中的自定义函数

除了开箱即用的功能，例如 总和 函数输出下列出的自定义函数，您可以编写经常需要的自定义函数。 确保您编写的函数附带 jsdoc 高于它。

随附 jsdoc 必需：

• 如果您需要自定义配置和描述
• 因为有多种方法可以在中声明函数 JavaScript, 和注释可让您跟踪功能。

规则编辑器支持脚本和自定义函数的JavaScript ES2015语法。
有关更多信息，请参阅 jsdoc.app.

支持 jsdoc 标记：

• 私人
  语法：私有函数不作为自定义函数包括在内。@private
  专用函数未作为自定义函数包含在内。

• 名称
  语法：可选 @name funcName <Function Name>
  或者 , 您可以使用： @function funcName <Function Name> 或 @func funcName <Function Name>.
  funcName 是函数的名称（不允许有空格）。
  <Function Name> 是函数的显示名称。

• 会员
  语法：将命名空间附加到函数。@memberof namespace
  将命名空间附加到函数。

• 参数
  语法：或者，您可以使用： @param {type} name <Parameter Description>
  或者，您可以使用： @argument {type} name <Parameter Description> 或 @arg {type} name <Parameter Description>.
  显示函数使用的参数。 一个函数可以有多个参数标记，每个参数按其出现顺序具有一个标记。
  {type} 表示参数类型。 允许的参数类型包括：

  1. 字符串
  2. 数字
  3. 布尔型
  4. 范围

  范围是指自适应表单的字段。 当表单使用延迟加载时，您可以使用 scope 以访问其字段。 您可以在加载字段时访问字段，也可以将字段标记为全局字段。

  所有参数类型均被归入上述参数类型之一。 不支持无。 确保选择以上类型之一。 类型不区分大小写。 参数中不允许有空格 name. <Parameter Descrption> <parameter> can have multiple words. </parameter>

• 返回类型
  语法：或者，您可以使用 @return {type}
  或者，您可以使用 @returns {type}.
  添加有关函数的信息，例如其目标。
  {type}表示函数的返回类型。 允许的返回类型包括：

  1. 字符串
  2. 数字
  3. 布尔型

  所有其他退货类型均归入上述任一类型之下。 不支持无。 确保选择以上类型之一。 返回类型不区分大小写。

  • 此
    语法：
    @this currentComponent
    使用@this可引用在其中写入规则的自适应表单组件。

  以下示例基于字段值。 在以下示例中，规则隐藏了表单中的一个字段。 此 this 部分 this.value 是指用于编写规则的底层自适应表单组件。

     /**
     * @function myTestFunction
     * @this currentComponent
     * @param {scope} scope in which code inside function will be executed.
     */
     myTestFunction = function (scope) {
        if(this.value == "O"){
              scope.age.visible = true;
        } else {
           scope.age.visible = false;
        }
     }
  

  注意

  使用自定义函数之前的注释进行摘要。 在遇到标记之前，摘要可以扩展到多行。 将大小限制为单个，以便在规则生成器中提供简要说明。

添加自定义函数

例如，要添加一个计算正方形区域的自定义函数。 Side length是自定义函数的用户输入，可使用表单中的数字框接受该输入。 计算的输出显示在表单的另一个数字框中。 要添加自定义函数，您必须先创建客户端库，然后将其添加到CRX存储库。

要创建客户端库并将其添加到CRX存储库中，请执行以下步骤：

1. 创建客户端对库执行以下步骤。 有关更多信息，请参阅 使用客户端库.

2. 在CRXDE中，添加属性 categories字符串类型值为 customfunction 到 clientlib 文件夹。

   注意

   customfunction是一个示例类别。 您可以为在中创建的类别选择任意名称 clientlib文件夹。

在CRX存储库中添加客户端库后，在自适应表单中使用该库。 它允许您在表单中将自定义函数用作规则。 要在自适应表单中添加客户端库，请执行以下步骤：

1. 在编辑模式下打开表单。
   要在编辑模式下打开表单，请选择表单并点按 打开.

2. 在编辑模式下，选择一个组件，然后点按 > 自适应表单容器，然后点按 .

3. 在侧栏中的Name of Client Library下，添加您的客户端库。 ( customfunction 在此示例中。)

   

4. 选择输入数字框，然后点按 以打开规则编辑器。

5. 点按 创建规则. 使用下面显示的选项，创建一个规则以在表单的“输出”字段中保存输入的平方值。

   

6. 点按 完成. 您的自定义函数已添加。

函数声明支持的类型

函数语句

function area(len) {
    return len*len;
}

此函数包含但不包含 jsdoc 注释。

函数表达式

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

函数表达式和语句

var b={};
/** */
b.area = function(len) {
    return len*len;
}

函数声明（变量）

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

限制：自定义函数仅从变量列表中选取第一个函数声明（如果同时选取）。 您可以对每个声明的函数使用函数表达式。

函数声明作为对象

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

管理规则

当您点按表单对象并点按时，会列出该对象上的任何现有规则 . 您可以查看标题并预览规则摘要。 此外，UI允许您展开和查看完整的规则摘要、更改规则的顺序、编辑规则以及删除规则。

您可以对规则执行以下操作：

• 展开/折叠：规则列表中的“内容”列显示规则内容。 如果整个规则内容在默认视图中不可见，请点按 以扩展它。

• 重新排序：您创建的任何新规则都将栈叠在规则列表的底部。 规则将从上到下执行。 顶部的规则先执行，然后是相同类型的其他规则。 例如，如果您分别将When、Show、Enable和When规则放在顶部的第一、第二、第三和第四个位置，则顶部的当When规则将首先执行，紧接着在第四个位置执行When规则。 然后，执行显示和启用规则。
  您可以通过点按来更改规则的顺序 或将其拖放到列表中的所需顺序。

• 编辑：要编辑规则，请选中规则标题旁边的复选框。 此时会显示用于编辑和删除规则的选项。 点按 编辑 在规则编辑器中打开选定的规则 .

• 删除：要删除规则，请选择该规则并点按 删除.

• 启用/禁用：当必须暂时暂停使用规则时，您可以选择一个或多个规则并点按 禁用 操作工具栏中的以禁用它们。 如果某个规则被禁用，则它不会在运行时执行。 要启用已禁用的规则，您可以选择该规则并点按操作工具栏中的启用。 规则的状态列显示规则是启用还是禁用。

复制粘贴规则

您可以将规则从一个字段复制粘贴到其他类似字段，以节省时间。

要复制粘贴规则，请执行以下操作：

1. 点按要从中复制规则的表单对象，然后在组件工具栏中点按 . 此时将显示规则编辑器用户界面，其中选定了表单对象，并显示现有规则。

   

   有关管理现有规则的信息，请参见 管理规则.

2. 选中规则标题旁边的复选框，将显示用于管理规则的选项。 点按​复制。

   

3. 选择要将规则粘贴到的其他表单对象，然后点按 粘贴. 此外，您还可以编辑规则以对其进行更改。

   注意

   仅当表单对象支持复制的规则事件时，您才可以将规则粘贴到另一个表单对象。 例如，按钮支持点击事件。 您可以将包含点击事件的规则粘贴到按钮，但不能粘贴到复选框。

4. 点按 完成 以保存规则。

嵌套表达式

规则编辑器允许您使用多个AND和OR运算符创建嵌套规则。 您可以在规则中混合使用多个AND和OR运算符。

以下是嵌套规则的示例，该规则会在满足所需条件时向用户显示有关儿童监护权资格的消息。

您还可以拖放规则中的条件以进行编辑。 点按并悬停在手柄上( )。 指针变为手形符号后（如下所示），将条件拖放到规则中的任意位置。 规则结构会发生变化。

日期表达式条件

规则编辑器允许您使用日期比较来创建条件。

以下是一个示例条件，当房屋抵押贷款已抵押时，该条件会显示一个静态文本对象，用户通过填写日期字段来表示该条件。

如果用户填写的财产抵押日期是过去，则自适应表单会显示有关收入计算的说明。 以下规则将用户填写的日期与当前日期进行比较，如果用户填写的日期早于当前日期，则表单会显示文本消息（名为Income）。

如果填写日期早于当前日期，则表单会显示以下文本消息（收入）：

数字比较条件

规则编辑器允许您创建比较两个数字的条件。

以下是一个示例条件，如果申请人在当前地址停留的月数小于36，则该条件会显示静态文本对象。

当用户表示在当前居住地址居住不到36个月时，表格显示可以请求更多居住证明的通知。

示例规则

调用表单数据模型服务

考虑使用Web服务 GetInterestRates 将贷款金额、使用期和申请人的信用评分作为输入，并返回包含EMI金额和利率的贷款计划。 使用Web服务作为数据源创建表单数据模型。 添加数据模型对象和 get 表单模型的服务。 该服务将显示在表单数据模型的“服务”选项卡中。 然后，创建一个自适应表单，其中包含数据模型对象中的字段，以捕获用户输入的贷款金额、使用期限和信用分数。 添加触发Web服务获取计划详细信息的按钮。 输出将填充到相应的字段中。

以下规则显示如何配置调用服务操作以完成示例场景。

使用自适应表单规则调用表单数据模型服务

使用When规则触发多个操作

在贷款申请表单中，您希望捕获贷款申请人是否为现有客户。 根据用户提供的信息，应显示或隐藏客户ID字段。 此外，如果用户是现有客户，则还需要将焦点设置为“客户ID”字段。 贷款申请表包括以下组成部分：

• 一个单选按钮， 您是否为Geometrixx现有客户？，它提供 是 和 否 选项。 “是”的值为 0 “否”为 1.

• 一个文本字段， Geometrixx客户ID，以指定客户ID。

在用于实施此行为的单选按钮上编写When规则时，该规则在可视规则编辑器中如下所示。

可视编辑器中的规则

在示例规则中，When部分中的语句是条件，该条件在返回True时执行Then部分中指定的操作。

在规则中使用函数输出

在采购订单表单中，您有下表，用户在该表中填写其订单。 在此表中：

• 第一行是可重复的，因此用户可以订购多个产品并指定不同的数量。 其元素名称为 Row1.
• 可重复行的“产品数量”列中的单元格的标题为“数量”。 此单元格的元素名称为 productquantity.
• 表中的第二行是不可重复的，该行中“产品数量”列中的单元格的标题为“总数量”。

答： Row1 B. 数量 C. 总数量

现在，您要为所有产品在“产品数量”列中添加指定数量，并在“总数量”单元格中显示总和。 可通过在“总数量”单元格中编写“设置值”规则来实现此总和，如下所示。

可视编辑器中的规则

使用表达式验证字段值

在上一个示例中说明的采购订单表单中，您需要限制用户订购任何数量超过该10000价的产品。 要执行此验证，您可以编写验证规则，如下所示。

可视编辑器中的规则