教程:将规则应用于自适应表单字段

06-apply-rules-to-adaptive-form_main

本教程是 创建您的第一个自适应表单 系列。 Adobe建议按时间顺序阅读本系列,以了解、执行和演示完整的教程用例。

关于教程

您可以使用规则将交互性、业务逻辑和智能验证添加到自适应表单。 自适应表单具有内置规则编辑器。 规则编辑器提供了与引导式导览类似的拖放功能。 拖放方法是创建规则的最快、最简单的方法。 规则编辑器还为有兴趣测试其编码技能或将规则提升到更高层次的用户提供了一个代码窗口。

要了解有关规则编辑器的更多信息,请访问 自适应Forms规则编辑器.

在本教程结束时,您将学习如何创建规则以:

  • 调用表单数据模型服务以从数据库中检索数据
  • 调用表单数据模型服务以将数据添加到数据库
  • 运行验证检查并显示错误消息

本教程每个部分末尾的交互式GIF图像可帮助您动态学习和验证所构建表单的功能。

步骤1:从数据库中检索客户记录

您通过以下方式创建了表单数据模型 创建表单数据模型 文章。 现在,您可以使用规则编辑器调用Forms数据模型服务,以检索信息并将其添加到数据库。

每个客户都分配有一个唯一的客户ID号,这有助于识别数据库中的相关客户数据。 以下过程使用客户ID从数据库中检索信息:

  1. 打开自适应表单进行编辑。

    http://localhost:4502/editor.html/content/forms/af/change-billing-shipping-address.html

  2. 点按 客户ID 字段并点按 编辑规则 图标。 此时将打开“规则编辑器”窗口。

  3. 点按 +创建 图标以添加规则。 该操作将打开可视编辑器。

    在可视编辑器中, 时间 语句默认处于选中状态。 此外,表单对象(在本例中, 客户ID)中,您启动规则编辑器的位置在 时间 语句。

  4. 点按 选择状态 下拉菜单并选择 已更改.

    whencustomeridischanged

  5. 语句,选择 调用服务选择操作 下拉菜单。

  6. 选择 检索送货地址 服务来自 选择 下拉菜单。

  7. 拖放 客户ID “表单对象”选项卡中的字段 拖放对象或在此选择 中的字段 输入 盒子。

    dropobjectstoinputfield-retrievedata

  8. 拖放 客户ID、名称、送货地址、省/市/自治区以及邮政编码 “表单对象”选项卡中的字段 拖放对象或在此选择 中的字段 输出 盒子。

    dropobjectstooutputfield-retrievedata

    点按 完成 以保存规则。 在规则编辑器窗口中,点按 关闭.

  9. 预览自适应表单。 在中输入ID 客户ID 字段。 该表单现在可以从数据库中检索客户详细信息。

    retrieve-information

步骤2:将更新的客户地址添加到数据库

从数据库中检索到客户详细信息后,您可以更新送货地址、省/市/自治区以及邮政编码。 以下过程调用表单数据模型服务将客户信息更新到数据库:

  1. 选择 提交 字段并点按 编辑规则 图标。 此时将打开“规则编辑器”窗口。

  2. 选择 提交 — 单击 规则并点按 编辑 图标。 此时会显示用于编辑“提交”规则的选项。

    submit规则

    在WHEN选项中, 提交已单击 已选择选项。

    submit-is-clicked

  3. 选项,点按 + Add语句 选项。 选择 调用服务选择操作 下拉菜单。

  4. 选择 更新送货地址 服务来自 选择 下拉菜单。

    update-shipping-address

    dropobjectstoinputfield-updatedata

  5. 拖放 送货地址、省/市/自治区以及邮政编码 中的字段 表单对象 选项卡中的相应tablename .property(例如customerdetails .shippingAddress) 拖放对象或在此选择 中的字段 输入 盒子。 以tablename为前缀的所有字段(例如,此用例中的customerdetails)用作更新服务的输入数据。 这些字段中提供的所有内容都会在数据源中更新。

    注意

    请勿拖放 名称客户ID 字段到相应的tablename.property(例如customerdetails.name)。 它有助于避免错误地更新客户的名称和ID。

  6. 拖放 客户ID 中的字段 表单对象 选项卡中的字段id 输入 盒子。 没有前缀表名的字段(例如,此用例中的客户详细信息)用作更新服务的搜索参数。 此 id 字段在此使用案例中唯一标识 customerdetails 表格。

  7. 点按 完成 以保存规则。 在规则编辑器窗口中,点按 关闭.

  8. 预览自适应表单。 检索客户详细信息、更新送货地址并提交表单。 再次检索同一客户的详细信息时,将显示更新的送货地址。

步骤3:(附加部分)使用代码编辑器运行验证并显示错误消息

您应该对表单运行验证,以确保在表单中输入的数据正确,并且在数据不正确的情况下显示错误消息。 例如,如果在表单中输入了不存在的客户ID,则会显示一条错误消息。

自适应表单提供了多个具有内置验证的组件,例如电子邮件和数值字段,您可以将其用于常见用例。 对于高级用例,使用规则编辑器可在数据库返回零(0)记录(无记录)时显示错误消息。

以下过程说明如何创建一个规则,以便在表单中输入的客户ID在数据库中不存在时显示错误消息。 规则还会将焦点置于并重置 客户ID 字段。 规则使用 表单数据模型服务的dataIntegrationUtils API 检查客户ID是否存在于数据库中。

  1. 点按 客户ID 字段并点按 Edit Rules 图标。 此 规则编辑器 窗口打开。

  2. 点按 +创建 图标以添加规则。 该操作将打开可视编辑器。

    在可视编辑器中, 时间 语句默认处于选中状态。 此外,表单对象(在本例中, 客户ID)中,您启动规则编辑器的位置在 时间 语句。

  3. 点按 选择状态 下拉菜单并选择 已更改.

    whencustomeridischanged

    语句,选择 调用服务选择操作 下拉菜单。

  4. 切换自 可视编辑器代码编辑器. 开关控件位于窗口的右侧。 此时将打开代码编辑器,其中显示类似于以下内容的代码:

    代码编辑器

  5. 将输入变量部分替换为以下代码:

    var inputs = {
        "id" : this
    };
    
  6. 更换 guidelib.dataIntegrationUtils.executeOperation (operationInfo, inputs, outputs) 部分,代码为:

    guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, function (result) {
      if (result) {
          result = JSON.parse(result);
        customer_Name.value = result.name;
        customer_Shipping_Address = result.shippingAddress;
      } else {
        if(window.confirm("Invalid Customer ID. Provide a valid customer ID")) {
              customer_Name.value = " ";
             guideBridge.setFocus(customer_ID);
        }
      }
    });
    
  7. 预览自适应表单。 输入不正确的客户ID。 出现一条错误消息。

    display-validation-error

在此页面上