配置提交操作 configuring-the-submit-action

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
自适应表单

创建对象：

用户

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

提交操作简介 introduction-to-submit-actions

当用户单击自适应表单上的“提交”按钮时，会触发提交操作。您可以在自适应表单上配置提交操作。自适应表单提供了一些现成的提交操作。您可以复制和扩展默认的提交操作，以创建您自己的提交操作。但是，根据您的要求，您可以编写并注册您自己的提交操作，以处理已提交表单中的数据。

预填或提交表单后，提交的数据将通过AEM路由，以便按摩到中间格式的数据。除非自适应表单使用Acrobat Sign、验证、表单门户草稿或提交或AEM工作流，否则数据不会保存在AEM实例中

您可以在提交自适应表单容器属性的部分。

配置提交操作
图： 配置提交操作

自适应表单可用的默认提交操作包括：

提交到REST端点
发送电子邮件
通过电子邮件发送PDF
调用Forms Workflow
使用表单数据模型提交
Forms Portal提交操作
调用AEM工作流

NOTE

通过电子邮件提交操作发送PDF仅适用于使用XFA模板作为表单模型的自适应表单。

NOTE

确保 [AEM_Installation_Directory]\crx-quickstart\temp\datamanager\ASM folder exists。临时存储附件需要目录。如果目录不存在，请创建该目录。

CAUTION

如果您预填充表单模板、表单数据模型或基于模式的自适应表单，其中包含XML或JSON数据，抱怨某个架构（XML架构、JSON架构、表单模板或表单数据模型）的数据不包含 <afdata>, <afbounddata>和 </afunbounddata> 标记，则无界字段的数据(无界字段是没有宾德雷夫属性)。

您可以为自适应表单编写自定义提交操作以完成用例。有关更多信息，请参阅为自适应表单编写自定义提交操作.

提交到REST端点 submit-to-rest-endpoint

的 提交到REST端点 提交选项会将表单中填写的数据传递到配置的确认页面，以作为HTTPGET请求的一部分。您可以添加要请求的字段名称。请求的格式为：

{fieldName}={request parameter name}

如下图所示， param1 和 param2 将作为参数进行传递，并且值复制自 文本框 和 数字框 字段。

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

配置Rest端点提交操作

NOTE

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

将提交的数据发布到资源或外部休息端点 post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

使用 提交到REST端点 操作将提交的数据发布到rest URL。 URL可以是内部服务器（呈现表单的服务器）或外部服务器。

要将数据发布到内部服务器，请提供资源的路径。数据将发布到资源的路径中。例如， /content/restEndPoint。对于这种帖子请求，使用提交请求的验证信息。

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

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

在上例中，用户在 textbox 使用参数捕获 param1. 用于发布使用 param1 为：

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

同样，用于发布XML数据和附件的参数也是 dataXml 和 attachments.

例如，在脚本中使用这两个参数将数据解析到其余的端点。使用以下语法来存储和解析数据：

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

在本例中， data 存储XML数据， att 存储附件数据。

发送电子邮件 send-email

的 发送电子邮件 成功提交表单后，提交操作会向一个或多个收件人发送电子邮件。生成的电子邮件可以包含预定义格式的表单数据。

NOTE

所有表单字段必须具有不同的元素名称，即使它们位于不同的面板中也是如此)，以便在电子邮件中包含表单数据。

通过电子邮件发送PDF send-pdf-via-email

的 通过电子邮件发送PDF 提交操作会在成功提交表单时，向一个或多个收件人发送一封包含表单数据的PDF的电子邮件。

注意： 此提交操作适用于基于XFA的自适应表单和具有记录文档模板的基于XSD的自适应表单。

调用表单工作流 invoke-a-forms-workflow

的 提交到Forms工作流 提交选项会向JEE进程上的现有AdobeLiveCycle或AEM Forms发送数据xml和文件附件（如果有）。

有关如何配置提交到表单工作流提交操作的信息，请参阅使用表单工作流提交和处理表单数据.

使用表单数据模型提交 submit-using-form-data-model

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

此外，您还可以使用表单数据模型和记录文档(DoR)将表单附件提交到数据源。

有关表单数据模型的信息，请参阅 AEM Forms数据集成.

Forms Portal提交操作 forms-portal-submit-action

的 Forms Portal提交操作 选项可通过AEM Forms门户提供表单数据。

有关Forms Portal和提交操作的更多信息，请参阅草稿和提交组件.

调用AEM工作流 invoke-an-aem-workflow

的 调用AEM工作流 提交操作可将自适应表单与AEM工作流相关联。提交表单后，关联的工作流将自动在处理节点上启动。此外，它还会将数据文件、附件和记录文档（如果适用）放置在工作流的有效负荷位置。

在使用 调用AEM工作流 提交操作，配置AEM DS设置. 有关创建AEM工作流的信息，请参阅 OSGi上以表单为中心的工作流.

自适应表单中的服务器端重新验证 server-side-revalidation-in-adaptive-form

通常，在任何在线数据捕获系统中，开发人员会在客户端放置一些JavaScript验证，以强制执行一些业务规则。但在现代浏览器中，最终用户可以绕过这些验证，使用各种技术（如Web浏览器开发工具控制台）手动执行提交。这种技术也适用于自适应表单。表单开发人员可以创建各种验证逻辑，但从技术上讲，最终用户可以绕过这些验证逻辑，将无效数据提交到服务器。无效数据会破坏表单作者强制执行的业务规则。

服务器端重新验证功能还允许运行自适应表单作者在服务器上设计自适应表单时提供的验证。它可防止在表单验证中表示的数据提交和业务规则违规的任何潜在危害。