在AEM Sites单页应用程序中嵌入自适应表单或交互式通信

概述

AEM Forms允许表单开发人员将自适应表单和交互式通信无缝嵌入AEM Sites单页应用程序(SPA)中。 嵌入式自适应表单和交互式通信功能完全,用户无需离开页面即可填写和提交表单。 它有助于用户停留在网页上其他元素的上下文中,并同时与自适应表单或交互式通信进行交互。

在AEM Sites单页应用程序中,您可以使用AEM Forms SPA容器组件 添加自适应表单或交互式通信。 它是适用于AEM Sites SPA的AEM Forms组件,您可以将其添加到站点页面。

有关在非SPA AEM Sites中嵌入自适应表单的信息,请参阅在AEM Sites页面中嵌入自适应表单或交互式通信

前提条件

要使用AEM Forms SPA容器组件在AEM站点SPA中嵌入自适应表单或交互式通信,请确保已安装:

安装AEM Forms SPA容器组件

执行以下步骤安装AEM Forms SPA容器组件:

  1. 克隆或下载适用于SPA的AEM Forms组件

  2. 安装适用于SPA的AEM Forms组件。 README.md文件中提供了安装组件的说明。

    该组件包含示例React组件,可用于将SPA容器组件与基于React的SPA项目集成。

  3. 克隆或下载基于React的SPA项目

  4. 使用README.md文件中提供的说明,将SPA容器组件与基于React的SPA项目集成。

    安装AEM Forms SPA容器组件并将该组件与基于React的SPA项目集成后,您可以在AEM Sites页面中嵌入自适应表单和交互式通信。

嵌入自适应表单或交互式通信

要使用AEM Forms for SPA容器组件嵌入自适应表单或交互式通信,请执行以下操作:

  1. 在编辑模式下打开AEM站点页面,您要在其中嵌入自适应表单或交互式通信。

  2. 使用以下任意选项在页面上插入​AEM For SPA​组件:

    • 点按“站点”页面上的布局容器,点按​+,然后选择​AEM For SPA​组件。

    • 从组件浏览器面板中,将​AEM For SPA​组件拖放到页面上。

    • 在资产浏览器中搜索自适应表单或交互式通信,并将其拖放到站点页面。 它将表单嵌入到AEM Forms for SPA组件容器中。

    注意

    不支持在页面上渲染多个AEM Forms SPA容器组件。 您可以在一个页面上包含多个AEM Forms SPA容器,但一次只渲染一个组件。 确保页面上只显示一个组件,以避免出现差异。

  3. 点按站点页面中嵌入的AEM Forms SPA容器组件,然后点按操作栏上的settings_icon。 将打开​编辑AEM Forms SPA容器​对话框。

  4. 在​编辑AEM Forms容器​对话框中,指定以下内容:

    • 资产类型: 选择要嵌入的资产类型。选项包括​自适应表单​和​交互式通信

    • 资产路径:浏览并选择要嵌入的自适应表单或交互式通信。如果使用资产浏览器插入自适应表单或交互式通信,则会自动填充该字段。

    • 渠道 (仅限交互式通信):选择要嵌入的交互式渠道类型。选项包括​Web渠道​和​打印渠道

    • 主题:选择一个主题,该主题定义自适应表单或交互式通信组件的样式。样式包括外观属性,如字体样式、背景颜色、尺寸和对齐方式。

  5. 点按done_icon以保存设置。 自适应表单或交互式通信现在嵌入到页面中。

发布嵌入式自适应表单和交互式通信

请考虑以下方案,以在AEM Sites页面上发布嵌入的资产(自适应表单或交互式通信):

  • 如果您是首次发布AEM Sites页面,并且该页面包含嵌入式自适应表单或交互式通信,请发布站点页面和嵌入的资产。
  • 如果您在已发布的站点页面中仅修改了嵌入的自适应表单或交互式通信,则应发布原始资产,并且所做的更改会反映在已发布的站点页面中。 发布的站点页面包含对资产的引用,无需重新发布页面。
  • 如果您修改了站点页面和嵌入的自适应表单或交互式通信,请重新发布站点页面和嵌入的资产。

修改嵌入式自适应表单和交互式通信

AEM站点页面在AEM Forms容器中维护对自适应表单和交互式通信的引用。 因此,在原始自适应表单和交互式通信中配置的所有配置和属性(如主题、样式和提交操作)都将保留在嵌入的自适应表单和交互式通信中。

要修改嵌入式自适应表单和交互式通信的任何配置或属性,请执行以下操作之一。

  • 在自适应表单中打开原始表单,或在相应编辑器中使用交互式通信打开并修改它们。
  • 在编辑模式下,从站点页面中点按自适应表单或交互式通信,然后点按​在新窗口中编辑。 在编辑模式下,将打开原始表单。

注意事项和最佳实践

在AEM站点页面中嵌入自适应表单时,请牢记以下几点:

  • 原始表单中的页眉和页脚未包含在嵌入的表单中。
  • 支持用户草稿和提交嵌入的表单,这些草稿和提交内容显示在表单门户的“草稿”和“已提交”Forms选项卡中。
  • 在原始表单上配置的提交操作将保留在嵌入表单中。
  • 在原始表单上配置的体验定位和A/B测试在嵌入的表单中不起作用。 但是,您可以使用“站点”页面上的体验定位来根据用户配置文件显示不同的表单。
  • 如果您为原始表单配置了Adobe Analytics,则会在Adobe Analytics中捕获嵌入表单的分析数据。 但是,它在表单分析报表中不可用。

在此页面上