为REST端点提交操作配置自适应表单
使用配置指定REST端点的功能是早期采用程序,仅适用于核心组件和Edge Delivery Services Forms。 您可以从官方电子邮件ID写入aem-forms-ea@adobe.com
以加入率先采用者计划并请求访问功能。
使用 提交到REST端点 操作将提交的数据发布到REST URL。 该 URL 可以属于内部服务器(呈现表单的服务器)或外部服务器。
AEM as a Cloud Service提供了多种现成的提交操作来处理表单提交。 您可以在自适应表单提交操作文章中了解有关这些选项的更多信息。
优点
为自适应Forms配置 提交到REST端点 提交操作的一些优点包括:
- 它通过RESTful API实现了表单数据与外部系统和服务的无缝集成。
- 它提供了灵活性,可处理从自适应Forms提交的数据,并支持动态和复杂的数据结构。
- 它支持将表单字段动态映射到REST端点URL中的参数,从而允许进行自适应和可自定义的数据提交。
配置提交到REST端点提交操作 steps-to-configure-submit-to-restendpoint-submit-action
要根据基于基础组件的自适应表单的Swagger Open API规范配置提交操作,请执行以下操作:
-
打开自适应表单进行编辑,然后导航到自适应表单容器属性的 提交 部分。
-
从 提交操作 下拉列表中,选择 提交到Rest终结点。
提交到Rest终结点的
要将数据发布到内部服务器,请提供资源的路径。数据将发布到资源的路径。例如,
/content/restEndPoint
。对于此类post请求,使用提交请求的验证信息。
此选项允许您直接输入目标REST端点。
要将数据发布到外部服务器,请提供 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
。要将数据提交到任何其他服务器,请使用绝对路径。 -
单击 完成。
要根据基于核心组件的自适应表单的Swagger Open API规范配置提交操作,请执行以下操作:
-
打开内容浏览器,然后选择自适应表单的 指南容器 组件。
-
单击指南容器属性
-
单击 提交 选项卡。
-
从 提交操作 下拉列表中,选择 提交到Rest终结点。
要将数据发布到内部服务器,请提供资源的路径。数据将发布到资源的路径。例如,
/content/restEndPoint
。对于此类 POST 请求,将使用提交请求的身份验证信息。您可以使用两个选项来指定REST端点:
accordion URL 此选项允许您直接输入目标REST端点。
要将数据发布到外部服务器,请提供 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
。要将数据提交到任何其他服务器,请使用绝对路径。
+++
accordion |
---|
配置 |
此选项允许您添加通过AEM的配置浏览器管理的预定义HTTP配置。 您可以选择为服务Rest端点身份验证类型和内容类型创建的配置。 要了解有关身份验证类型和内容类型的更多信息,请访问配置数据源 |
- 单击 完成。
要根据在Universal Editor中为自适应表单创作的Swagger Open API规范配置提交操作,请执行以下操作:
-
打开自适应表单进行编辑。
-
单击编辑器上的 编辑表单属性 扩展。
出现 表单属性 对话框。note note NOTE - 如果您在通用编辑器界面中未看到 编辑表单属性 图标,请在Extension Manager中启用 编辑表单属性 扩展。
- 请参阅Extension Manager功能亮点一文,了解如何在通用编辑器中启用或禁用扩展。
1. 单击**提交**选项卡,然后选择**提交到Rest终结点**提交操作。
要将数据发布到内部服务器,请提供资源的路径。数据将发布到资源的路径。例如,
/content/restEndPoint
。对于此类 POST 请求,将使用提交请求的身份验证信息。您可以使用两个选项来指定REST端点:
accordion URL 此选项允许您直接输入目标REST端点。
要将数据发布到外部服务器,请提供 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
。要将数据提交到任何其他服务器,请使用绝对路径。
+++
accordion |
---|
配置 |
此选项允许您添加通过AEM的配置浏览器管理的预定义HTTP配置。 您可以选择为服务Rest端点身份验证类型和内容类型创建的配置。 要了解有关身份验证类型和内容类型的更多信息,请访问配置数据源 |
- 单击 保存并关闭。
最佳实践
- 将数据发布到外部服务器时,请确保URL安全,并配置路径以匿名处理POST请求以保护敏感信息。
- 要将字段作为 REST URL 中的参数传递,所有字段都必须具有不同的元素名称,即使这些字段位于不同的面板上也是如此。