设置和配置AEM Forms引用站点 set-up-and-configure-aem-forms-reference-sites

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

AEM Forms提供参考站点实施,以演示AEM Forms如何帮助金融服务行业和政府组织在任何设备上随时随地将其复杂交易转换为简单而引人入胜的数字体验。

We.Finance和We.Gov参考网站利用真实的用例与现有和潜在客户进行互动,从首次接触开始,以个性化且经济高效的方式管理信函和交易。

利用参考网站,可探索和展示AEM Forms的以下主要功能。

  • 简化了引人入胜的响应式自适应表单和交互式通信的创作体验。
  • 交互式通信,创建可适应设备设置和布局的交互式、个性化和响应式客户通信。
  • 数据集成以连接到不同的数据源,通过表单数据模型预填和提交表单数据。
  • Forms工作流,可自动执行业务流程和工作流。
  • 高级用户数据管理和处理功能。
  • 与Acrobat Sign集成,以安全地签署和提交自适应表单。
  • 与Adobe Target集成,以提供有针对性的推荐并执行A/B测试,从而最大限度地提高表单投资回报率。
  • 与Adobe Analytics集成,以衡量表单或营销策划的效果并做出明智的决策。
  • 增强表单填写体验。

参考站点提供了可重复使用的资产,您可以将这些资产用作模板来创建自己的资产。

  • 与Acrobat Sign集成,以安全地签署和提交自适应表单。

  • 与Acrobat Sign集成,以安全地签署和提交自适应表单。

设置引用站点的先决条件和步骤 prerequisites-and-steps-to-set-up-reference-sites

在设置引用站点之前,请确保您具有以下内容:

  • AEM essentials

    AEM快速入门、AEM Forms附加组件包和引用站点包。 请参阅 AEM Forms版本 有关附加组件和引用站点包的详细信息。

  • SMTP服务
    您可以使用任何SMTP服务。

  • Acrobat Sign开发人员帐户和Acrobat Sign API应用程序

    要使用数字签名功能,需要Acrobat Sign开发人员帐户。 请参阅 Acrobat Sign.

  • 要与Microsoft集成的AEM Forms 365运行实例。 要运行引用站点,需将示例数据导入Microsoft Dynamics实例,以预填充引用站点中使用的交互式通信。

  • 包含Forms附加组件包的AEM 6.4运行实例。 有关更多信息,请参阅 安装和配置AEM Forms.

按照建议的顺序执行以下步骤以设置和配置引用站点。

步骤
配置
注释
安装和配置AEM Forms
创作和发布
安装和配置AEM Forms创作和发布实例。
配置SSL
创作和发布
启用HTTP over SSL以与Acrobat Sign进行安全通信。
配置Day CQ Link Externalizer配置
创作和发布
参考网站用例为不同交易发送电子邮件。 通过电子邮件发送新闻稿时需要此设置。 它可确保URL和图像指向发布实例。
配置Day CQ Mail Service
创作和发布
电子邮件通信需要。
覆盖默认的XSS配置
发布
用于覆盖xss安全性阻止的$、{和}字符。
配置AEM DS设置
创作
配置AEM DS以在发布实例上提交表单,并在创作实例上处理工作流。
部署引用站点包
创作
在AEM Forms创作实例上部署引用站点包。
将示例数据导入Microsoft Dynamics
创作和发布
为信用卡申请、住房抵押申请和住房保险申请过程导入样本数据
为Microsoft Dynamics配置OAuth云服务
创作和发布
在AEM Forms中配置OAuth云服务,以启用AEM Forms与Microsoft Dynamics之间的通信。
配置Acrobat Sign调度程序
创作和发布
更改调度程序的配置,每两分钟检查一次状态。
配置参考站点Acrobat SignCloud Service
创作和发布
引用站点附带的配置包,需要使用有效凭据重新配置。
为匿名用户配置Forms通用配置服务
发布
该配置允许为匿名用户提交、签署和生成记录文档。
修改表单数据模型的Rest服务Swagger文件
创作和发布
修改环境的服务。

安装和配置AEM Forms install-and-configure-aem-forms

安装和部署AEM Forms,如 在OSGi上安装和配置AEM Forms.

NOTE
如果多个发布实例或创作和发布实例位于不同的计算机上,则配置复制和反向复制代理。

配置SSL ssl

需要SSL配置才能与Acrobat Sign服务器通信。 有关详细步骤,请参阅 启用HTTP Over SSL.

CAUTION
请勿配置强制SSL开启 /etc/map 文件夹。

在AEM中, 外部器 是一项OSGi服务,允许您通过预配置DNS来预定路径,以编程方式将资源路径(例如/path/to/my/page)转换为外部和绝对URL(例如https://www.mycompany.com/path/to/my/page)。 请参阅 外部化URL.

CAUTION
如果您对SSL使用自签名证书,请勿将其外部化为HTTPS URL。
此外,对于本地服务器,请使用localhost而不是其主机名。

对创作实例和发布实例执行以下步骤:

  1. 转到OSGi配置: https://<主机名>:<端口>/system/console/configMgr。

  2. 查找并点按 Day CQ链接外部器 配置。

    将打开Day CQ Link Externalizer对话框,用于编辑配置。

  3. 在Day CQ Link Externalizer(日CQ链接外部器)对话框的Domains(域)字段中:

    • 在创作实例上,指定可从外部系统访问的发布URL。 例如,主机名或发布Web服务器。
    • 在发布实例上,指定创作URL和发布URL。
  4. 在创作实例和发布实例上,确保在“域”字段中指定本地服务器URL。

  5. 点按 保存. 等待一段时间,以便所有服务都重新启动。

配置Day CQ Mail Service cqmail

引用网站实施要求在填写和提交表单时向示例用户发送电子邮件。 配置Day CQ Mail Service允许您提供SMTP服务详细信息,以向客户发送自动电子邮件。 请参阅 配置电子邮件通知.

执行以下步骤以在发布实例上配置邮件服务:

  1. 转到OSGi配置: https://<主机名>:<端口>/system/console/configMgr。
  2. 查找并点按 Day CQ Mail Service 以将其打开进行配置。
  3. 提供SMTP服务器主机名和端口值。
  4. 点按 保存.
NOTE
您可以使用企业SMTP服务或Gmail等公共服务。 有关配置SMTP服务的信息,请参阅SMTP服务文档。

覆盖默认的XSS配置 xss

We.Finance参考网站的电子邮件模板在电子邮件中包含个性化链接。 这些链接的占位符作为 ${placeholder}. 在发送电子邮件之前,这些占位符会被替换为实际值。 AEM的默认XSS保护配置不允许大括号({ })来访问HTML内容。 但是,您可以对发布实例执行以下步骤来覆盖默认配置:

  1. 复制 /libs/cq/xssprotection/config.xml to /apps/cq/xssprotection/config.xml.

  2. 打开 /apps/cq/xssprotection/config.xml.

  3. common-regexps 修改 onsiteURL ,然后保存文件。

    <regexp name="onsiteURL" value="([\p{L}\p{N}\\\.\#@\$\{\}%\+&;\-_~,\?=/!\*\(\)]*|\#(\w)+)"/>

NOTE
大括号({ })作为接受字符包含在URL中的HTML内容中。

配置SMTP服务器后,尝试使用Sarah Rose角色填写表单,并将其另存为草稿。 另存为草稿时,您可以选择通过电子邮件接收草稿。 点按 发送电子邮件 按钮,则当您收到一封包含应用程序草稿链接的电子邮件时,您的电子邮件配置会成功。 确保您使用Sarah的凭据登录以查看草稿。

配置AEM DS设置 aemds

AEM DS服务设置是引用站点用例中用于电子邮件通信的发布实例中的必需设置。 有关在发布实例上配置AEM DS服务设置的详细步骤,请参阅 配置AEM DS设置.

对于AEM Forms引用站点,在AEM DS设置服务中,指定发布服务器的URL,而不是处理服务器的URL。

CAUTION
不要放 /lc (如果要为AEM Forms OSGi配置)。

部署引用站点包 refsite

使用Software Distribution安装以下引用站点包。

要了解有关如何使用包的更多信息,请参阅 如何使用包.

安装包并启动创作和发布实例后,请在浏览器中访问以下URL:

  • https://[server]:[port]/wegov
  • https://[server]:[port]/wefinance

如果安装成功,您可以访问We.Gov和We.Finance引用网站登陆页面。

(可选)将示例数据导入Microsoft Dynamics optional-import-sample-data-into-microsoft-dynamics

住房抵押申请和汽车保险申请参考站点被配置为使用来自Microsoft Dynamics的记录。 引用站点包会安装自定义实体和示例记录,您可以将其导入Microsoft Dynamics以运行引用站点。 执行以下步骤以迁移和设置示例数据:

要导入汽车保险申请的自定义实体,请执行以下操作:

  1. 下载 WeFinanceAutoInsurance_1_0.zip 解决方案包来自 https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/WeFinanceAutoInsurance_1_0.zip 在AEM创作实例上。
  2. 在Microsoft Dynamics实例中,转到 解决方案设置 菜单,单击 导入. 选择并导入资源包。

要导入汽车保险申请的自定义实体,请执行以下操作:

  1. 下载 AEMFormsFSIRefsite_1_0.zip https://中的包[作者]:[端口]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/AEMFormsFSIRefsite_1_0.zip。 选择并导入资源包。

  2. 在Microsoft Dynamics实例中,转到 解决方案设置 菜单,单击 导入. 选择并导入资源包。

要导入客户和保险单记录,请执行以下操作:

  1. 下载 We.Finance Customers.csv、We.Finance Auto Insurance Renuvars.csv ​和 住房抵押 来自AEM创作实例上以下位置的数据文件:

    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Customers.csv
    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Auto Insurance Renewals.csv
    • https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/Sarah%20Rose%20Contact.csv
  2. 在Microsoft Dynamics实例中,执行以下操作:

    • 转到 销售> We.Finance客户 单击 导入.
    • 转到 销售> We.Finance汽车保险 单击 导入.
    • 转到 Sales > We.Finance Home Mortage 单击 导入.

为Microsoft Dynamics配置OAuth云服务 configure-oauth-cloud-service-for-microsoft-dynamics

在AEM Forms中配置OAuth云服务,以启用AEM Forms与Microsoft Dynamics之间的通信。 执行以下步骤以在AEM创作和发布实例上配置OAuthCloud Service:

  1. 在AEM创作实例上,转到 工具>Cloud Services>数据源>全局. 点按 刷新Dynamics集成 图标,点按 属性.
  2. 转到Microsoft Azure Active Directory帐户。 在 回复URL 为注册的应用程序设置。 保存配置。
  3. 在“身份验证设置”选项卡中,指定 服务根, 客户端Id, 客户端密钥 ​和 资源URL 的Microsoft Dynamics实例。 单击 连接到OAuth 重定向到Microsoft Dynamics登录页面的ID错误。
  4. 提供您的登录凭据。 登录后,您将被重定向到AEM Forms云服务配置页面。 单击“保存并关闭”。云服务配置已保存。
  5. 转到 Forms >数据集成> We.Finance. 选择“自动保险(动态)”,然后单击“编辑”。 Microsoft Dynamics实体列在数据源选项卡下。 等待直到从Microsoft Dynamics获取所有实体,并将其列在数据源选项卡下。
  6. 选择 自动保险续订实体 单击 测试模型对象. 在输入请求部分中,将客户ID的值指定为“900001”,然后单击 测试. “输出”部分显示从Microsoft Dynamics获取的客户ID 900001的记录。
  7. 在输入请求部分中,将客户ID的值指定为“900001”,然后单击 测试. “输出”部分显示从Microsoft Dynamics获取的客户ID 900001的记录。
  8. 对发布实例重复步骤1-6。

配置Acrobat Sign调度程序 scheduler

在创作实例和发布实例上执行以下操作:

  1. 转到AEM Web配置控制台(位于 https://[server]:[host]/system/console/configMgr.

  2. 查找并点按 Acrobat Sign配置服务 以将其打开进行配置。

  3. 配置 状态更新调度程序表达式 as 0 0/2 ***?.

    note note
    NOTE
    上述调度程序配置每两分钟检查一次Acrobat Sign服务的状态。
  4. 点按 保存.

配置参考站点Acrobat Sign云服务 sign-service

在创作实例和发布实例上执行以下操作:

  1. 转到 工具>Cloud Services> Acrobat Sign >全局. 选择 AEM Forms参考站点标记 点按 属性.

    note caution
    CAUTION
    确保https://[主机]:[ssl_port]/mnt/overlay/adobesign/cloudservices/adobesign/properties.html URL已添加到Acrobat Sign API应用程序OAuth配置的重定向URL列表。
  2. 指定Acrobat Sign应用程序OAuth配置的客户端ID和密钥。

  3. (可选)选择 还为附件启用Acrobat Sign 选项,然后点按 连接到Acrobat Sign. 它会将附加到自适应表单的文件附加到发送进行签名的相应Acrobat Sign文档。

  4. 点按 连接到Acrobat Sign 并使用您的Acrobat Sign凭据登录。

配置Forms Common Configuration Service anonymous

在发布实例上执行以下操作,以允许匿名用户访问:

  1. 转到AEM Web配置控制台(位于 https://[server]:[port]/system/console/configMgr.
  2. 查找并点按 Forms通用配置服务 以将其打开进行配置。
  3. 配置 允许 字段 所有用户.
  4. 点按 保存.

修改表单数据模型的Rest服务 fdm

在创作实例和发布实例上执行以下操作:

  1. 转到CRXDE() https://[server]:[port]/crx/de/index.jsp.
  2. 导航到 /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile 并打开swagger文件。
  3. 根据您的环境更新主机和端口设置。
  4. 保存设置。
  5. (仅限创作实例)转到 工具 > Cloud Services > 数据源 > 全球. 选择 roi-rest 点按 属性. 点按 身份验证设置 设置 身份验证类型 to 基本身份验证. 指定 admin/ admin作为访问服务的用户名/密码。 点按 保存并关闭.

与Marketing Cloud集成 integrate-with-marketing-cloud

您可以将AEM Forms与Adobe Analytics和Adobe Target集成。 虽然Adobe Analytics可以帮助您生成报表并分析自适应表单的性能,但Adobe Target可以帮助您提供个性化体验并执行自适应表单的A/B测试。

执行以下操作以在AEM Forms中配置Adobe Analytics和Adobe Target。

配置Adobe Analytics configure-adobe-analytics

AEM Forms与Adobe Analytics集成允许您监控和分析客户与表单和文档的交互方式。 它有助于您识别和修复问题区域,并采取措施提高转化率。

要在参考网站中体验此功能,请按照 配置分析和报表.

要生成报表,种子数据会与引用站点捆绑在一起。 在使用种子数据之前,请执行以下操作:

  1. 确保AEM云服务中提供We.Finance和We.Gov分析配置。 您可以通过以下方式之一找到云服务:

    • 导航到 工具>Cloud Services>旧版Cloud Services 或浏览https://<host>:<port>/libs/cq/core/content/tools/cloudservices.html。
    • Cloud Services 页面,下 Adobe Analytics ,单击 Show Configurations. 您可以看到We.Finance和We.Gov的可用配置。 单击以打开配置。 在配置页面中,单击 编辑. 提供有效的公司、用户名、共享密钥(密码)和数据中心并单击 连接到Analytics. 连接成功对话框后,单击 确定 在“配置”对话框中。 按照 配置Analytics和报表.
  2. 导航到https://<主机>:<端口>/system/console/configMgr并执行以下操作:

    • Web控制台配置 页面,查找并单击 AEM Forms Analytics配置.
    • SiteCatalyst框架 在“AEM Forms Analytics配置”对话框的字段中,选择we-finance(we-finance)或we-gov(we-gov)。
    • 单击 保存 并让页面刷新。
  3. 导航到位于https://的表单管理器<host>:<port>/aem/forms并执行以下操作:

    • 打开We.Finance或We.Gov文件夹,然后选择要查看其报表的表单。
    • 在“操作”工具栏中单击启用Analytics 。 为表单启用分析后,单击“分析报表”。 您可以看到生成的空白报表。 生成空白报表后,您必须提供推荐包随附的种子数据,才能生成用于演示目的的分析报表。

    参考网站提供分析报告,其中包含信用卡、住房抵押和儿童支持用例的种子数据。 有关种子数据的配置,请参阅 We.Finance参考站点演练We.Gov引用站点演练.

配置Target configure-target

参考网站展示了AEM Forms与Adobe Target的集成,允许您在自适应文档中包含有针对性的个性化内容。 它还支持为自适应表单创建A/B测试。

要在参考站点中体验集成,请执行以下操作以在AEM中配置Target:

  1. 使用jvm参数启动创作快速启动 -Dabtesting.enabled=true 在服务器上启用A/B测试。

    注意:如果AEM实例在JBoss(从Turnkey安装以服务形式启动)上运行,请添加 -Dabtesting.enabled=true 参数 jboss\bin\standalone.conf.bat 文件, :

    set "JAVA_OPTS=%JAVA_OPTS% -Dadobeidp.serverName=server1 -Dfile.encoding=utf8 -Djava.net.preferIPv4Stack=true -Dabtesting.enabled=true"

  2. 访问https://<主机名>:<端口>/libs/cq/core/content/tools/cloudservices.html。

  3. Adobe Target ,单击 显示配置. 您可以看到We.Finance Target配置的可用。 单击以打开配置。 在配置页面中,单击 编辑. 的 编辑组件 将打开配置对话框。

  4. 指定与Target帐户关联的客户端代码、电子邮件和密码。 将API类型选为 REST.

  5. 单击 连接到Adobe目标. 成功配置Target帐户后,单击 确定. 您可以看到打包的配置具有Target框架。

  6. 转到https://<主机名>:<端口>/system/console/configMgr。

  7. 单击 AEM Forms Target配置.

  8. 选择Target框架。

  9. 目标URL 字段中,指定指向AEM Forms的URL。 例如:https://<主机名>:<端口> 。

  10. 单击“保存”。

信用卡应用程序和住房抵押贷款应用程序用例演示了如何执行A/B测试并展示用于演示目的的报告。 有关演练,请参阅 We.Finance参考站点演练.

下一步 next-step

现在,您都可以浏览参考站点。 有关参考站点工作流和步骤的更多信息,请参阅:

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da