AEM コネクタの実装

最終更新日： 2024年10月28日
  • トピック：

作成対象：

  • 管理者

以下に、AEM コネクタの作成に役立つリファレンスを示します。コネクタの送信と保守に関するガイダンスと併せてお読みください。

AEM の開発者用ライセンスは、Adobe Exchange プログラムを通じて取得できます。

一般的な統合パターン

AEM は最先端の Web エクスペリエンス管理ソリューションで、様々な領域で統合をおこなえる可能性があります。一般的な統合パターンは次のとおりです。

  • 外部システムから AEM にデータを取り込む。例えば、CRM から連絡先情報を書き出して、AEM を利用した Web サイトを訪問する広範なオーディエンスに公開するような場合です。実装では、Sling のスケジュール済みジョブを使用する必要があります。これにより、コンテナが停止してもジョブの実行が保証されます。ジョブが複数回トリガーされる可能性があることを前提として、コードを設計する必要があります。
  • AEM から外部システムにデータを書き出す。例えば、ニュースレターの購読設定は、AEM を活用した web サイトで CRM に送信されます。
  • AEM からアセットを取得する。例えば、AEM Assets に保存されているアセットを外部のコンテンツ管理システム（CMS）で参照するような場合です。別の例としては、PIM システムから AEM Assets 内の画像にリンクする場合もあります。
  • アセットを AEM インフラストラクチャに保存する。例えば、マーケティングリソース管理（MRM）システムで承認済みアセットを AEM Assets に保存するような場合です。
  • カスタム UI コンポーネントを設定およびレンダリングする。例えば、作成者がビデオコンポーネントをドラッグ＆ドロップして、ライブサイトで特定のビデオを再生できるように設定するような場合です。
  • パートナーサービスを使用してアセットに対する操作をおこなう。例えば、ページが公開されたときにアセットをビデオプラットフォームに送信するような場合です。
  • AEM Admin Console でサイト、ページ、アセットを分析する。例えば、既存ページまたは未公開ページの SEO のレコメンデーションを提示するような場合です。
  • 外部サービスで管理されているユーザーデータにページレベルでアクセスする。例えば、人口統計情報を利用してサイトのエクスペリエンスをパーソナライズするような場合です。詳しくは、ContextHub に関する情報を参照してください。ContextHub は、コンテキストデータを保存、操作、表示するためのフレームワークです。
  • サイトコピーまたはアセットメタデータを翻訳する。AEM 翻訳フレームワークを使用したサンプルコード（翻訳コネクタの推奨される実装）については、AEM 翻訳フレームワークブートストラップコネクタを参照してください。

有用なドキュメント

Adobe Experience Manager as a Cloud Service のドキュメントでは、AEM での開発に関する有益なインサイトを提供します。また、以下に示す特定の技術トピックおよびリファレンスは、AEM コネクタの実装時に役に立つ可能性があります。

  • アドビコンサルティングサービス（ACS）の AEM サンプル：AEM 開発者の参考になるコメント付きコードを参照できます
  • この記事の「一般的な統合パターン」の節で示した様々なドキュメントリンク

コミュニティリソース

上記の静的ドキュメントに加えて、アドビおよび AEM コミュニティでは、コネクタの市場投入に役立つ以下のリソースを提供しています。

パッケージ構成ルール

ローリングデプロイメントを容易にするために、コネクタなどの AEM as a Cloud Service パッケージでは、「不変」コンテンツと「可変」コンテンツを厳密に区別しています。パッケージは、次の内容を含むように明確に整理する必要があります。

  • /apps
  • /content および /conf

コネクタは、パッケージ化に関するこれらのガイドラインに従う必要があります。ガイドラインについては、AEM プロジェクトの構造を参照してください。既存のコネクタは、ガイドラインに準拠するためにリファクタリングも必要になります。

さらに、/libs にコードを書き込むのはアドビだけで、ユーザーとパートナーは /apps にコードを書き込みます。

既存のコネクタの場合、一度 /etc に配置した設定を他の最上位フォルダー（/conf など）に移動するには、コネクタのリファクタリングも必要になる可能性があります。この再構築は AEM 6.5 の一部としておこなわれ、AEM 6.5 のドキュメントで説明されています。

アドビでは、特に複数のコネクタを使用するお客様向けに、クリーンなリポジトリ構造を維持するために、コネクタコードのほとんどを /apps/connectors/<vendor> の配下に格納することをお勧めします。

クラウドサービスの設定

コネクタ実装の 1 つの側面として、コネクタの設定をサポートするコードがあります。このコードにより、ツール／操作／Cloud Services で、コネクタ名の付いたカードが表示されるようになります。カードをクリックすると、設定ブラウザーがポップアップ表示され、コネクタ設定を含んだ親フォルダーをユーザーが選択できます。コネクタのコードによって、設定が必要なすべてのプロパティを含んだフォームが生成され、最終的に、/conf の配下の設定フォルダーにプロパティ値が格納されます。このフォルダーは、後ほど「サイトのプロパティ」タブまたは「アセットのプロパティ」タブで選択できます。