实施 AEM 连接器

下面提供了构建 AEM 连接器的有用参考,应结合有关提交维护连接器的指导阅读这些参考。

请注意,可通过AdobeExchange程序获取AEM的开发人员许可证。

常见集成模式

AEM是一款先进的web体验管理解决方案,提供了许多潜在的集成领域。 常见的集成模式包括:

  • 将数据从外部系统提取到AEM。 例如,从CRM导出联系信息,以将其提供给访问AEM支持的网站的更广泛受众。 实施应使用Sling的计划作业,这可保证即使容器关闭也执行作业。 代码应设计为假定该作业可能多次触发。
  • 将数据从AEM导出到外部系统。 例如,在以AEM为后盾的网站上向CRM提交了新闻稿订阅设置。
  • 从AEM检索资产。 例如,引用存储在AEM Assets中的资产的外部内容管理系统(CMS)。 或者,再比如PIM系统链接到AEM Assets中的图像。
  • 在AEM基础架构中存储资产。 例如,在AEM Assets中存储已批准资产的营销资源管理(MRM)系统。
  • 配置和渲染自定义UI组件。 例如,允许作者拖放视频组件并配置要在实时网站上播放的特定视频。
  • 通过合作伙伴服务对资产执行操作。 例如,在发布页面时向视频平台发送资产。
  • 在AEM管理控制台中分析网站、页面或资产。 例如,为现有页面或未发布页面提供SEO推荐。
  • 对由外部服务维护的用户数据的页面级访问。 例如,利用人口统计信息对网站体验进行个性化。 阅读有关ContextHub的信息,ContextHub是用于存储、处理和呈现上下文数据的框架。
  • 翻译网站副本或资产元数据。 有关使用AEM翻译框架的示例代码,请参阅AEM翻译框架Bootstrap连接器,该示例代码是翻译连接器的首选实现。

有用文档

Experience Manager作为Cloud Service文档提供了在AEM中进行开发的有价值分析。 以下是在实施AEM连接器时可能会发现有用的一些特定技术主题和参考:

  • Adobe咨询服务(ACS) AEM示例 ,提供了有条理的代码,以帮助教育AEM开发人员
  • 本文“常用集成模式”部分中的各种文档链接

社区资源

除了上述静态文档之外,Adobe和AEM社区还提供资源来帮助将连接器推向市场:

  • Adobe社区的AEM论坛是一个活动网站,您的同行可在该网站提问并回答相关问题
  • 其他Adobe技术资源适用于特定合作伙伴级别。 了解有关AdobeExchange程序的更多信息。
  • 如果贵组织希望获得实施帮助,请考虑 Adobe 的专业服务团队或参阅解决方案合作伙伴查找器,获取 Adobe 全球合作伙伴列表

包结构规则

为了支持滚动部署,AEM作为Cloud Service包(例如连接器)在“不可变”和“可变”内容之间有严格的分隔。 应将包清晰地分隔为以下两个包:

  • /apps
  • /content/conf

连接器应遵循这些包装准则,本文中对此进行了描述。 还应对现有连接器进行重构以符合要求。

此外,只有Adobe才应将代码写入/libs,客户和合作伙伴应将代码写入/apps

可能需要重构现有连接器,以将曾经放置/etc的任何配置移入其他顶级文件夹,如/conf。 此重组是作为AEM 6.5的一部分完成的,在AEM 6.5文档中有相关说明。

建议将大部分连接器代码置于/apps/connectors/<vendor>下,以便为具有多个连接器的客户推广干净的存储库结构。

Cloud Services配置

连接器实现的一个方面是支持连接器配置的代码。 此代码会导致在“工具”>“操作”>“Cloud Services”下显示带有连接器名称的信息卡。 单击后,会弹出一个配置浏览器,其中客户选择要包含连接器配置的父文件夹。 连接器的代码应该生成一个包含所有必须配置的属性的表单,最终将这些值存储在/conf下的配置文件夹中。 稍后可以在站点属性选项卡或资产属性选项卡下选择此文件夹。

上下文感知配置

上下文感知 配置允许在不同文件夹(包括下的文件夹、子文件 /libs夹和 /apps子文件夹) /conf 之间进行层 /conf配置。它支持继承,以便客户在对每个微型站点进行特定更改时能够配置全局配置。 由于此功能可用于Cloud Services配置,因此连接器代码应使用上下文感知配置API引用配置,而不是引用特定配置节点。

如果连接器中使用了经过修改的配置,请设计连接器以处理包括/合并连接器提供的默认配置的任何未来更新以及任何客户配置。 请记住,在未经客户警告和同意的情况下更改自定义(如客户更改的)内容或配置,可能会使用其Connector中断(或创建意外行为)。

编码最佳实践

由于AEM as a Cloud Service是云原生解决方案,因此有一些准则可能会影响连接器的代码策略。 有关更多详细信息,请参阅AEM as a Cloud Service开发准则

测试AEM Connector

应使用本地环境开发技术创建新连接器(或修改现有连接器)。 合作伙伴团队将为ISV合作伙伴提供一个沙盒环境,在该环境中,他们可以将其AEM Connector部署到原版应用程序,以确保它正常工作。

在此页面上