自适应表单提交操作 configuring-the-submit-action

适用于：✔️自适应表单基础组件。 ❌自适应表单核心组件。 Adobe建议使用核心组件来将自适应Forms添加到AEM Sites页面或创建独立的自适应Forms。

当用户单击自适应表单上的​ 提交 ​按钮时，会触发提交操作。 Formsas a Cloud Service提供了以下开箱即用的提交操作。

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

您可以在侧边栏的自适应表单容器属性的​ 提交 ​部分中配置提交操作。

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

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

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

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

在上面的示例中，使用参数 param1 捕获用户在 textbox 中输入的信息。用于发布使用 param1 捕获的数据的语法为：

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

同样，用于发布 XML 数据和附件的参数为 dataXml 和 attachments。

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

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

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

提交到 REST 端点 ​提交操作将表单中填入的数据作为 HTTP GET 请求的一部分提交到配置的确认页面。您可以添加要请求的字段的名称。请求的格式为：

{fieldName}={request parameter name}

如下图所示，param1 和 param2 作为参数传递，其值是从下一操作中使用的​ 文本框 ​和​ 数字框 ​字段复制的。

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

发送电子邮件 send-email

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

```

${customer_Name}，您好！

以下内容设定为您的默认配送地址：
${customer_Name}，
${customer_Shipping_Address}，
${customer_State}，
${customer_ZIPCode}

此致，
WKND

```

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

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

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

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

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

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

该提交操作将以下内容放置在工作流的负载位置或变量中（如果为外部数据存储标记了工作流）：

使用​ 调用 AEM 工作流 ​提交操作之前，为 AEM DS 设置服务 ​配置进行以下设置：

提交到 SharePoint submit-to-sharedrive

提交到 SharePoint ​提交操作将自适应表单与 Microsoft® SharePoint 存储连接起来。您可以将表单数据文件、附件或记录文档提交到连接的Microsoft® Sharepoint存储。

通过使用提交到SharePoint，您可以：

将自适应表单连接到SharePoint文档库 connect-af-sharepoint-doc-library

要在自适应表单中使用​ 提交到SharePoint文档库 ​提交操作，请执行以下操作：

创建SharePoint文档库配置 create-sharepoint-configuration

要将AEM Forms连接到Microsoft®Sharepoint文档库存储，请执行以下操作：

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

在自适应表单中使用SharePoint文档库配置 use-sharepoint-configuartion-in-af

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

提交表单时，数据将保存在指定的Microsoft® Sharepoint文档库存储中。
用于保存数据的文件夹结构是 /folder_name/form_name/year/month/date/submission_id/data。

将自适应表单连接到Microsoft® SharePoint列表 connect-af-sharepoint-list

要在自适应表单中使用提交到SharePoint列表提交操作，请执行以下操作：

创建SharePoint列表配置 create-sharepoint-list-configuration

要将AEM Forms连接到Microsoft®Sharepoint列表：

在自适应表单中使用表单数据模型(FDM)提交 use-submit-using-fdm

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

提交表单时，数据将保存在指定的Microsoft® Sharepoint列表存储中。

提交到 OneDrive submit-to-onedrive

提交到 OneDrive ​提交操作将自适应表单与 Microsoft® OneDrive 连接起来。您可以将表单数据、文件、附件或记录文档提交到连接的 Microsoft® OneDrive 存储。要在自适应表单中使用提交到 OneDrive 提交操作，请执行以下操作：

创建 OneDrive 配置 create-onedrice-configuration

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

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

在自适应表单中使用 OneDrive 配置 use-onedrive-configuartion-in-af

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

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

提交到 Azure Blob 存储 submit-to-azure-blob-storage

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

创建 Azure Blob 存储容器 create-azure-configuration

要将 AEM Forms 连接到 Azure 存储容器，请执行以下操作：

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

在自适应表单中使用 Azure 存储配置 use-azure-storage-configuartion-in-af

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

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

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

提交至 Power Automate microsoft-power-automate

您可以配置自适应表单以在提交时运行 Microsoft® Power Automate Cloud Flow。配置的自适应表单将捕获的数据、附件和记录文档发送到 Power Automate Cloud Flow 进行处理。它可帮助您构建自定义数据捕获体验，同时利用 Microsoft® Power Automate 的强大功能围绕捕获的数据构建业务逻辑并自动执行客户工作流。以下几个示例说明了在将自适应表单与 Microsoft® Power Automate 集成后可执行的操作：

自适应表单编辑器提供​ 调用 Microsoft® Power Automate 流程 ​提交操作，以将自适应表单数据、附件和记录文档发送到 Power Automate Cloud Flow。要使用提交操作将捕获的数据发送到 Microsoft® Power Automate，请将 Forms as a Cloud Service 实例与 Microsoft® Power Automate 关联

在成功配置后，使用调用 Microsoft® Power Automate 流程提交操作将数据发送到 Power Automate Flow。

提交到 Workfront Fusion workfront-fusion

您可以配置自适应表单，以便在提交时将数据提交到Workfront Fusion。 Workfront Fusion允许流程自动化，以便用户能够专注于新任务，而不是一次又一次地重复相同的任务。 它自动化了简单和复杂的任务，节省了时间并确保了一致的流程执行。

自适应Forms编辑器提供​ 调用Workfront Fusion方案 ​提交操作以将自适应Forms数据或附件发送到Workfront Fusion方案。 要使用提交操作将捕获的数据发送到Workfront Fusion方案，请参阅将自适应表单提交到Adobe Workfront Fusion。

使用同步或异步提交 use-synchronous-or-asynchronous-submission

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

同步提交：传统上，Web 表单配置为以同步方式提交。在同步提交中，当用户提交表单时，他们将重定向到确认页面、感谢页面或（如果提交失败）错误页面。您可以选择​ 使用异步提交 ​选项，将用户重定向到网页或在提交时显示消息。

异步提交：像单页面应用程序这样的现代 Web 体验越来越受欢迎，其中网页保持静态，而客户端与服务器的交互在后台进行。您现在可以通过配置异步提交来使用自适应表单提供此体验。

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

通常，在任何在线数据捕获系统中，开发人员都会在客户端放置一些 JavaScript 验证来强制实施一些业务规则。但在现代浏览器中，最终用户有办法绕过这些验证，并使用各种技术（例如，Web Browser DevTools Console）手动进行提交。此类技术也适用于自适应表单。尽管表单开发人员可以创建各种验证逻辑，但从技术上讲，最终用户可以绕过这些验证逻辑并向服务器提交无效数据。无效数据会破坏表单作者强制实施的业务规则。

此外，利用服务器端重新验证功能，可以运行自适应表单作者在服务器上设计自适应表单时提供的验证。这可防止任何可能的数据提交损害和与表单验证相关的业务规则违反情况。

在服务器上进行哪些验证？ what-to-validate-on-server-br

在服务器上重新运行的自适应表单的所有现成的 (OOTB) 字段验证包括：

启用服务器端验证 enabling-server-side-validation-br

使用边栏中自适应表单容器下方的​ 在服务器上重新验证，可以为当前表单启用或禁用服务器端验证。

启用服务器端验证

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

支持验证表达式中的自定义函数 supporting-custom-functions-in-validation-expressions-br

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

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

作者可以为每个自适应表单配置自定义 JavaScript 库。该库中只保留可重用的函数，这些函数依赖 jquery 和 underscore.js 第三方库。

提交操作的错误处理 error-handling-on-submit-action

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

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