自适应表单提交操作

提交操作在用户单击 提交 按钮。 自适应Forms提供了一些开箱即用的提交操作。 现成的“提交操作”包括:

您还可以 扩展默认提交操作 以创建您自己的提交操作。

您可以在中配置提交操作 提交 部分(位于侧栏中)。

配置提交操作

提交到REST端点

使用 提交到REST端点 将提交的数据发布到rest URL的操作。 URL可以是内部(渲染表单的服务器)或外部服务器。

要将数据发布到内部服务器,请提供资源的路径。 数据被发布为资源的路径。 例如,/content/restEndPoint。 对于此类post请求,使用提交请求的身份验证信息。

要向外部服务器发布数据,请提供URL。 URL的格式为 https://host:port/path_to_rest_end_point. 确保将路径配置为匿名处理POST请求。

作为感谢页面参数传递的字段值的映射

在上面的示例中,用户在 textbox 使用参数捕获 param1. 用于发布使用捕获的数据的语法 param1 为:

String data=request.getParameter("param1");

同样,用于发布XML数据和附件的参数包括 dataXmlattachments.

例如,在脚本中使用这两个参数将数据解析到rest端点。 您可以使用以下语法来存储和解析数据:

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

在此示例中, data 存储XML数据,以及 att 存储附件数据。

提交到REST端点 提交操作在HTTPGET请求过程中,将表单中填写的数据提交到配置的确认页面。 您可以添加要请求的字段的名称。 请求的格式为:

{fieldName}={request parameter name}

如下图所示, param1param2 作为参数传递,其值复制自 文本框numericbox 用于执行下一个操作的字段。

配置Rest端点提交操作

您还可以 启用POST请求 并提供用于发布请求的URL。 要将数据提交到托管表单的AEM服务器,请使用与AEM服务器的根路径对应的相对路径。 例如, /content/forms/af/SampleForm.html. 要向任何其他服务器提交数据,请使用绝对路径。

注意

要在REST URL中将这些字段作为参数传递,所有字段必须具有不同的元素名称,即使这些字段位于不同的面板上也是如此。

发送电子邮件

您可以使用 发送电子邮件 提交操作可在成功提交表单时向一个或多个收件人发送电子邮件。 生成的电子邮件可以包含预定义格式的表单数据。 例如,在以下模板中,将从提交的表单数据中检索客户名称、送货地址、省/直辖市/自治区名称和邮政编码。

```

${customer_Name},您好:

以下内容设置为您的默认送货地址:
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

致敬,
WKND

```
注意
  • 所有表单字段必须具有不同的元素名称,即使这些字段位于自适应表单的不同面板上也是如此。
  • AEMas a Cloud Service要求对出站邮件进行加密。 默认情况下禁用出站电子邮件。 要激活它,请将支持票证提交到 请求访问.

您还可以将附件和记录文档(DoR)包含到电子邮件中。 启用 附加记录文档 选项,配置自适应表单以生成记录文档(DoR)。 您可以启用选项以从自适应表单属性生成记录文档。

使用表单数据模型提交

使用表单数据模型提交 提交操作将表单数据模型中指定数据模型对象的已提交自适应表单数据写入其数据源。 在配置提交操作时,您可以选择提交的数据要写回其数据源的数据模型对象。

此外,您还可以使用表单数据模型和记录文档(DoR)将表单附件提交到数据源。 有关表单数据模型的信息,请参阅 AEM Forms 数据集成.

调用AEM Workflow

调用AEM Workflow 提交操作将自适应表单与 AEM Workflow. 提交表单时,关联的工作流会在创作实例上自动启动。 可将数据文件、附件和记录文档保存到工作流的有效负荷位置或变量。 如果工作流标记为外部数据存储并配置为外部数据存储,则只有变量选项可用。 您可以从可用于工作流模型的变量列表中进行选择。 如果工作流在稍后阶段标记为外部数据存储,而不是在创建工作流时标记为外部数据存储,则请确保已设置所需的变量配置。

提交操作将以下内容置于工作流的有效负荷位置,如果工作流标记为外部数据存储,则置于变量:

  • 数据文件:它包含提交到自适应表单的数据。 您可以使用 数据文件路径 选项,用于指定文件的名称以及相对于有效负荷的文件路径。 例如, /addresschange/data.xml path创建一个名为的文件夹 addresschange 并将其相对于有效负荷放置。 您也可仅指定 data.xml 只发送已提交的数据而不创建文件夹层次结构。 如果工作流标记为外部数据存储,请使用变量选项,并从工作流模型的可用变量列表中选择变量。

  • 附件:您可以使用 附件路径 选项,用于指定用于存储已上载到自适应表单的附件的文件夹名称。 将创建相对于有效负荷的文件夹。 如果工作流标记为外部数据存储,请使用变量选项,并从工作流模型的可用变量列表中选择变量。

  • 记录文档:它包含为自适应表单生成的记录文档。 您可以使用 记录文档路径 用于指定记录文档文件的名称以及相对于有效负荷的文件路径的选项。 例如, /addresschange/DoR.pdf path创建一个名为的文件夹 addresschange 相对于有效负荷,并放置 DoR.pdf 相对于有效负荷。 您也可仅指定 DoR.pdf 仅保存记录文档,而不创建文件夹层次结构。 如果工作流标记为外部数据存储,请使用变量选项,并从工作流模型的可用变量列表中选择变量。

使用之前 调用AEM Workflow 提交操作为配置以下 AEM DS设置服务 配置:

  • 处理服务器URL:处理服务器是触发Forms或AEM Workflow的服务器。 这可以与AEM创作实例或其他服务器的URL相同。

  • 处理服务器用户名:工作流用户的用户名

  • 处理服务器密码:工作流用户的密码

提交到 SharePoint

提交到SharePoint 提交操作可将自适应表单与Microsoft® SharePoint存储相关联。 您可以将表单数据文件、附件或记录文档提交到连接的Microsoft® Sharepoint存储。 要使用 提交到SharePoint 以自适应表单提交操作:

  1. 创建SharePoint配置:用于将AEM Forms连接到您的Microsoft® Sharepoint存储。
  2. 在自适应表单中使用提交到SharePoint提交操作:它将您的自适应表单连接到配置的Microsoft® SharePoint。

创建SharePoint配置

要将AEM Forms连接到Microsoft® Sharepoint存储,请执行以下操作:

  1. 转到您的 AEM Forms Author 实例> 工具 > Cloud Services > Microsoft® SharePoint.

  2. 一旦您选择 Microsoft® SharePoint,您将被重定向到 SharePoint浏览器.

  3. 选择 配置容器. 该配置将存储在选定的配置容器中。

  4. 单击​创建。此时将显示SharePoint配置向导。
    Sharepoint配置

  5. 指定 标题客户端ID客户端密码OAuth URL. 有关如何检索OAuth URL的客户端ID、客户端密钥和租户ID的信息,请参阅 Microsoft®文档.

    • 您可以检索 Client IDClient Secret 从Microsoft® Azure门户访问您的应用程序。
    • 在Microsoft® Azure门户中,将重定向URI添加为 https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Replace [author-instance] 使用创作实例的URL。
    • 添加API权限 offline_accessSites.Manage.All 以提供读/写权限。
    • 使用OAuth URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Replace <tenant-id> 使用 tenant-id 从Microsoft® Azure门户访问您的应用程序。
    注意

    客户端密码 字段是必填字段还是可选字段取决于您的Azure Active Directory应用程序配置。 如果您的应用程序配置为使用客户端密码,则必须提供客户端密码。

  6. 单击 Connect. 成功连接后, Connection Successful 出现消息。

  7. 现在,选择 SharePoint站点 > 文档库 > SharePoint文件夹,以保存数据。

    注意
    • 默认情况下, forms-ootb-storage-adaptive-forms-submission 在选定的SharePoint站点中存在。
    • 创建文件夹为 forms-ootb-storage-adaptive-forms-submission,如果列表中尚未出现 Documents 选定SharePoint站点的库,方法是单击 创建文件夹.

现在,您可以在自适应表单中将此SharePoint Sites配置用于提交操作。

在自适应表单中使用SharePoint配置

您可以在自适应表单中使用创建的SharePoint配置,将数据或生成的记录文档保存在SharePoint文件夹中。 执行以下步骤以在自适应表单中使用SharePoint存储配置,如下所示:

  1. 创建 自适应表单.

    注意
    • 选择相同的 配置容器 自适应表单,您已在该表单中创建了SharePoint存储空间。
    • 如果否 配置容器 选择,然后全局 存储配置 文件夹出现在“提交操作”属性窗口中。
  2. 选择 提交操作 作为 提交到SharePoint.
    SharepointGIF

  3. 选择 存储配置,以保存数据。

  4. 单击 保存 以保存提交设置。

提交表单时,数据将保存在指定的Microsoft® Sharepoint存储中。
要保存数据的文件夹结构为 /folder_name/form_name/year/month/date/submission_id/data.

提交到 OneDrive

提交到OneDrive 提交操作将自适应表单与Microsoft® OneDrive连接。 您可以将表单数据、文件、附件或记录文档提交到连接的Microsoft® OneDrive存储。 要使用 提交到OneDrive 以自适应表单提交操作:

  1. 创建OneDrive配置:用于将AEM Forms连接到您的Microsoft® OneDrive存储。
  2. 在自适应表单中使用提交到OneDrive提交操作:它将您的自适应表单连接到配置的Microsoft® OneDrive。

创建OneDrive配置

要将AEM Forms连接到Microsoft® OneDrive存储,请执行以下操作:

  1. 转到您的 AEM Forms Author 实例> 工具 > Cloud Services > Microsoft® OneDrive.

  2. 一旦您选择 Microsoft® OneDrive,您将被重定向到 OneDrive浏览器.

  3. 选择 配置容器. 该配置将存储在选定的配置容器中。

  4. 单击​创建。出现OneDrive配置向导。

    OneDrive配置屏幕

  5. 指定 标题客户端ID客户端密码OAuth URL. 有关如何检索OAuth URL的客户端ID、客户端密钥和租户ID的信息,请参阅 Microsoft®文档.

    • 您可以检索 Client IDClient Secret 从Microsoft® Azure门户访问您的应用程序。
    • 在Microsoft® Azure门户中,将重定向URI添加为 https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html. Replace [author-instance] 使用创作实例的URL。
    • 添加API权限 offline_accessFiles.ReadWrite.All 以提供读/写权限。
    • 使用OAuth URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Replace <tenant-id> 使用 tenant-id 从Microsoft® Azure门户访问您的应用程序。
    注意

    客户端密码 字段是必填字段还是可选字段取决于您的Azure Active Directory应用程序配置。 如果您的应用程序配置为使用客户端密码,则必须提供客户端密码。

  6. 单击 Connect. 成功连接后, Connection Successful 出现消息。

  7. 现在,选择 OneDrive容器 > [OneDrive文件夹] 以保存数据。

    注意
    • 默认情况下, forms-ootb-storage-adaptive-forms-submission 存在于OneDrive容器中。
    • 创建文件夹为 forms-ootb-storage-adaptive-forms-submission,如果尚未出现,请单击 创建文件夹.

现在,您可以在自适应表单中将此OneDrive存储配置用于提交操作。

在自适应表单中使用OneDrive配置

您可以在自适应表单中使用创建的OneDrive存储配置,将数据或生成的记录文档保存在OneDrive文件夹中。 执行以下步骤,在自适应表单中使用OneDrive存储配置,如下所示:

  1. 创建 自适应表单.

    注意
    • 选择相同的 配置容器 自适应表单,您已在该表单中创建了OneDrive存储。
    • 如果否 配置容器 选择,然后全局 存储配置 文件夹出现在“提交操作”属性窗口中。
  2. 选择 提交操作 作为 提交到OneDrive.
    OneDriveGIF

  3. 选择 存储配置,以保存数据。

  4. 单击 保存 以保存提交设置。

提交表单时,数据将保存在指定的Microsoft® OneDrive存储中。
要保存数据的文件夹结构为 /folder_name/form_name/year/month/date/submission_id/data.

提交到 Azure Blob Storage

提交到Azure Blob存储 提交操作可将自适应表单与Microsoft® Azure门户连接。 您可以将表单数据、文件、附件或记录文档提交到连接的Azure存储容器。 要对Azure Blob存储使用提交操作,请执行以下操作:

  1. 创建Azure Blob存储容器:用于将AEM Forms连接到Azure Storage容器。
  2. 在自适应表单中使用Azure存储配置 :它将您的自适应表单连接到配置的Azure存储容器。

创建Azure Blob存储容器

要将AEM Forms连接到Azure Storage容器,请执行以下操作:

  1. 转到您的 AEM Forms Author 实例> 工具 > Cloud Services > Azure存储.

  2. 一旦您选择 Azure存储,您将被重定向到 Azure存储浏览器.

  3. 选择 配置容器. 该配置将存储在选定的配置容器中。

  4. 单击​创建。将显示“创建Azure存储配置”向导。

    Azure存储配置

  5. 指定 标题Azure存储帐户Azure访问密钥.

    • 您可以检索 Azure Storage Account 名称和 Azure Access key 从Microsoft® Azure门户中的存储帐户。
  6. 单击“保存”。

现在,您可以在自适应表单中将此Azure存储容器配置用于提交操作。

在自适应表单中使用Azure存储配置

您可以在自适应表单中使用创建的Azure存储容器配置,以将数据或生成的记录文档保存在Azure存储容器中。 执行以下步骤以在自适应表单中使用Azure存储容器配置,如下所示:

  1. 创建 自适应表单.

    注意
    • 选择相同的 配置容器 自适应表单,您已在该表单中创建了OneDrive存储。
    • 如果否 配置容器 选择,然后全局 存储配置 文件夹出现在“提交操作”属性窗口中。
  2. 选择 提交操作 作为 提交到Azure Blob存储.
    Azure Blob存储GIF

  3. 选择 存储配置,以保存数据。

  4. 单击 保存 以保存提交设置。

提交表单时,数据将保存在指定的Azure存储容器配置中。
要保存数据的文件夹结构为 /configuration_container/form_name/year/month/date/submission_id/data.

要设置配置的值,请使用 AEM SDK 生成 OSGi 配置,并向 Cloud Service 实例部署配置

使用同步或异步提交

提交操作可以使用同步或异步提交。

同步提交:传统上,Web窗体配置为同步提交。 在同步提交中,当用户提交表单时,他们将被重定向到确认页面、感谢页面,或者如果提交失败,则被重定向到错误页面。 您可以选择 使用异步提交 用于将用户重定向到网页或在提交时显示消息的选项。

配置提交操作

异步提交:单页应用程序等现代Web体验越来越受欢迎,这是因为在后台进行客户端 — 服务器交互时,网页保持静态。 现在,您可以通过以下方式为自适应Forms提供此体验 配置异步提交.

自适应表单中的服务器端重新验证

通常,在任何在线数据捕获系统中,开发人员都会在客户端放置一些JavaScript验证,以实施一些业务规则。 但在现代浏览器中,最终用户能够绕过这些验证,并使用各种技术(如Web浏览器DevTools控制台)手动提交内容。 此类技术对于自适应Forms也有效。 表单开发人员可以创建各种验证逻辑,但从技术上讲,最终用户可以绕过这些验证逻辑并将无效数据提交到服务器。 无效数据将破坏表单作者已强制执行的业务规则。

通过服务器端重新验证功能,还可以在服务器上运行Adaptive Forms作者在设计Adaptive Form时提供的验证。 它可防止在表单验证方面可能出现的任何数据提交和业务规则违规受损。

要在服务器上验证什么?

在服务器上重新运行的自适应表单的所有开箱即用(OOTB)字段验证包括:

  • 必填
  • 验证图片子句
  • 验证表达式

启用服务器端验证

使用 在服务器上重新验证 在侧栏中的自适应表单容器下,启用或禁用当前表单的服务器端验证。

启用服务器端验证

启用服务器端验证

如果最终用户绕过这些验证并提交表单,服务器将再次执行验证。 如果验证在服务器端失败,则提交事务将停止。 最终用户将再次看到原始表单。 捕获的数据和提交的数据将作为错误呈现给用户。

注意

服务器端验证验证表单模型。 建议为验证创建单独的客户端库,并且不要在同一客户端库中将其与HTML样式和DOM操作等其他内容混合。

在验证表达式中支持自定义函数

有时候,如果有 复杂验证规则,精确验证脚本驻留在自定义函数中,作者从字段验证表达式中调用这些自定义函数。 要使此自定义函数库在执行服务器端验证时已知且可用,表单作者可以在下配置AEM客户端库的名称 基本 “自适应表单容器”属性的选项卡,如下所示。

在验证表达式中支持自定义函数

在验证表达式中支持自定义函数

作者可以按自适应表单配置customJavaScript库。 在库中,仅保留依赖于jquery和underscore.js第三方库的可重用函数。

提交操作的错误处理

作为AEM安全和强化指南的一部分,请配置自定义错误页面,如400.jsp、404.jsp和500.jsp。 在提交表单时出现400、404或500错误时,将调用这些处理程序。 在Publish节点上触发这些错误代码时,也会调用处理程序。 您还可以为其他HTTP错误代码创建JSP页。

当您将表单数据模型或基于XML或JSON数据投诉模式的自适应表单预填充到数据不包含的架构时 <afData><afBoundData>、和 </afUnboundData> 标签时,自适应表单中无界字段的数据将丢失。 架构可以是XML架构、JSON架构或表单数据模型。 未限定的字段是自适应表单字段,不带 bindref 属性。

在此页面上