为自适应表单编写自定义提交操作 writing-custom-submit-action-for-adaptive-forms

自适应表单需要提交操作才能处理用户指定的数据。 “提交”操作确定使用自适应表单对您提交的数据执行的任务。 Adobe Experience Manager(AEM)包括 OOTB提交操作 演示了使用用户提交的数据可以执行的自定义任务。 例如，您可以执行各种任务，如发送电子邮件或存储数据。

提交操作的工作流 workflow-for-a-submit-action

流程图描述了在单击 提交 按钮。 文件附件组件中的文件将上传到服务器，并且表单数据会更新为已上传文件的URL。 在客户端中，数据以JSON格式存储。 客户端向内部Servlet发送Ajax请求，该Servlet按摩您指定的数据，并以XML格式返回。 客户端将此数据与操作字段进行整理。 它通过“表单提交”操作将数据提交到最终Servlet（指南提交Servlet）。 然后，Servlet将控件转发到Submit操作。 “提交”操作可以将请求转发到其他sling资源，或将浏览器重定向到其他URL。

XML数据格式 xml-data-format

XML数据将使用 jcr:data 请求参数。 提交操作可以访问参数以处理数据。 以下代码描述XML数据的格式。 绑定到表单模型的字段显示在 afBoundData 中。 未绑定字段显示在 afUnoundData 中。 有关 data.xml 文件，请参阅 预填充自适应表单字段的简介.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

操作字段 action-fields

提交操作可添加隐藏的输入字段(使用HTML 输入 标记)到呈现的表单HTML。 这些隐藏字段可以包含处理表单提交时需要的值。 提交表单时，这些字段值将作为请求参数发回，提交操作可在提交处理过程中使用这些参数。 输入字段称为操作字段。

例如，如果“提交”操作也捕获填写表单所花费的时间，则可以添加隐藏的输入字段 startTime 和 endTime.

脚本可以提供 startTime 和 endTime 字段。 提交操作脚本 post.jsp 然后，可以使用请求参数访问这些字段并计算填写表单所需的总时间。

文件附件 file-attachments

提交操作还可以使用您使用文件附件组件上传的文件附件。 提交操作脚本可以使用sling访问这些文件 RequestParameter API. 的 isFormField API的方法可帮助识别请求参数是文件还是表单字段。 您可以在“提交”操作中迭代请求参数，以标识“文件附件”参数。

以下示例代码标识请求中的文件附件。 接下来，它使用 获取API. 最后，它使用数据创建一个Document对象并将其附加到列表。

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

转发路径和重定向URL forward-path-and-redirect-url

执行所需操作后，Submit servlet会将请求转发到转发路径。 操作使用setForwardPath API在指南提交Servlet中设置前进路径。

如果操作未提供转发路径，则提交Servlet会使用重定向URL重定向浏览器。 作者使用自适应表单编辑对话框中的感谢页面配置来配置重定向URL。 您还可以通过提交操作或指南提交servlet中的setRedirectUrl API来配置重定向URL。 您还可以使用指南提交servlet中的setRedirectParameters API配置发送到重定向URL的请求参数。

提交操作 submit-action

“提交”操作是一个sling:Folder，其中包含以下内容：

创建自定义提交操作 creating-a-custom-submit-action

执行以下步骤以创建一个自定义提交操作，该操作将数据保存在CRX存储库中，然后向您发送电子邮件。 自适应表单包含将数据保存到CRX存储库的OOTB提交操作存储内容（已弃用）。 此外，CQ还提供 邮件 可用于发送电子邮件的API。 在使用邮件API之前， [配置](https://docs.adobe.com/docs/en/cq/current/administering/notification.html?#Configuring Mail Service)Day CQ Mail服务通过系统控制台。 您可以重复使用“存储内容（已弃用）”操作将数据存储在存储库中。 “存储内容（已弃用）”操作可在CRX存储库的/libs/fd/af/components/guidesubmittype/store位置执行。