创建自适应Forms的自定义提交操作 writing-custom-submit-action-for-adaptive-forms

自适应表单提供多个现成的提交操作(OOTB)。 提交操作可指定要对通过自适应表单收集的数据执行的操作的详细信息。 例如，通过电子邮件发送数据。

您可以创建自定义提交操作以添加中未包含的功能 现成提交操作 或者不支持通过单个OOTB提交操作。 例如，将数据提交到工作流，将数据保存在数据存储中，向提交表单的人员发送电子邮件通知，并通过单个提交操作向负责处理已提交表单以供审批和拒绝的人员发送电子邮件。

XML数据格式 xml-data-format

使用将XML数据发送到servlet jcr:data 请求参数。 提交操作可以访问参数以处理数据。 以下代码描述了XML数据的格式。 绑定到表单模型的字段显示在 afBoundData 部分。 未绑定字段显示在 afUnoundData部分。

<?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

执行所需的操作后，提交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存储库中，并向您发送电子邮件。 自适应表单包含OOTB提交操作存储内容（已弃用），可将数据保存在CRX存储库中。 此外，AEM还提供 邮件 可用于发送电子邮件的API。 在使用Mail API之前，通过系统控制台配置Day CQ Mail服务。 您可以重用“存储内容（已弃用）”操作将数据存储在存储库中。 在CRX存储库中的/libs/fd/af/components/guidesubmittype/store位置提供了“存储内容（已弃用）”操作。

将submitService属性用于自定义提交操作 submitservice-property

设置自定义提交操作时，包括 submitService 属性，则表单会触发 FormSubmittactionService 提交时。 此 FormSubmitActionService 使用 getServiceName 用于检索值 submitService 属性。 根据 submitService 属性，则服务会调用相应的提交方法。 包括 FormSubmitActionService 至您上传到的自定义捆绑包 AEM Forms 服务器。

添加 submitService 字符串类型的属性 sling:Folder ，用于启用您的自定义提交操作 Adobe Sign 用于自适应表单。 您可以选择 启用Adobe Sign 中的选项 电子签名 设置值之后才可进行自适应表单容器属性的部分 submitService 自定义提交操作的属性。