为REST端点提交操作配置自适应表单

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

AEMas a Cloud Service提供了多种现成的提交操作来处理表单提交。 有关这些选项的更多信息,请参阅 自适应表单提交操作 文章。

优点

配置 提交到REST端点 自适应Forms的提交操作包括:

  • 它通过RESTful API实现了表单数据与外部系统和服务的无缝集成。
  • 它提供了灵活性,可处理从自适应Forms提交的数据,并支持动态和复杂的数据结构。
  • 它支持将表单字段动态映射到REST端点URL中的参数,从而允许进行自适应和可自定义的数据提交。

配置提交到REST端点提交操作 steps-to-configure-submit-to-restendpoint-submit-action

要配置提交操作,请执行以下操作:

  1. 打开内容浏览器,然后选择自适应表单的​ 指南容器 ​组件。

  2. 单击指南容器属性 指南属性 图标。这将打开“自适应表单容器”对话框。

  3. 单击​ 提交 ​选项卡。

  4. 提交操作 下拉列表,选择 提交到Rest端点.
    提交到Rest端点的操作配置

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

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

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

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

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

    同样,用于发布 XML 数据和附件的参数为 dataXmlattachments

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

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

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

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

    {fieldName}={request parameter name}

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

    配置 REST 端点提交操作

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

  5. 单击​ 完成

最佳实践

  • 将数据发布到外部服务器时,请确保URL的安全,并配置该路径以匿名方式处理POST请求以保护敏感信息。
  • 要将字段作为 REST URL 中的参数传递,所有字段都必须具有不同的元素名称,即使这些字段位于不同的面板上也是如此。

相关文章

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab