AEM Content and Commerce の使用を開始するには、AEM Content and Commerce Add-On for AEM 6.5 をインストールする必要があります。
AEM 6.5 サービスパック 7 以降が必要です。
AEM Content and Commerce のオンボードは、次の 2 つの手順で構成されています。
AEM Content and Commerce Add-On for AEM 6.5 をインストールする
お使いのコマースソリューションに AEM を接続する
ソフトウェア配布ポータルから AEM Commerce Add-On for AEM 6.5 をダウンロードしてインストールします。
必要な AEM 6.5 サービスパックをインストールして起動します。入手可能な最新のサービスパックをインストールすることをお勧めします。
AEM Managed Service のお客様の場合、これは CSE が行います。
AEM は、AEM 用のアクセス可能な GraphQL エンドポイントを持つ任意のコマースシステムに接続できます。これらのエンドポイントは通常、公開されているか、個々のプロジェクトの設定に応じて、プライベート VPN またはローカル接続を介して接続することができます。
オプションで、認証が必要な追加の CIF 機能を使用するために認証ヘッダーを指定できます。
AEM プロジェクトアーキタイプで生成されたプロジェクトと、 デフォルト設定に既に含まれている AEM Venia 参照用ストアは調整が必要です。
com.adobe.cq.commerce.graphql.client.impl.GraphqlClientImpl~default.cfg.json
の url
の値をコマースシステムの GraphQL エンドポイントに置き換えます。この設定を行うには、OSGi コンソールを使用するか、プロジェクトを介して OSGi 設定をデプロイします。ステージングシステムと実稼動システムは、異なる AEM 実行モードを使用して異なる設定にすることができます。
AEM Content and Commerce Add-On および CIF コアコンポーネントでは、AEM サーバーサイド接続とクライアントサイド接続の両方を使用します。クライアントサイド CIF コアコンポーネントと CIF アドオンオーサリングツールは、デフォルトで /api/graphql
に接続されます。これは、CIF Cloud Service 設定で必要に応じて調整できます(以下を参照)。
CIF アドオンでは、/api/graphql
に GraphQL プロキシサーブレットが用意されているので、オプションでこれをローカル開発に使用できます。実稼動デプロイメントの場合は、AEM Dispatcher を使用して、または他のネットワークレイヤー(CDN など)で、コマース GraphQL エンドポイントへのリバースプロキシを設定することを強くお勧めします。
このアドオンと CIF コアコンポーネント は、異なるコマースストア(またはストア表示など)に接続された複数の AEM サイト構造で使用できます。デフォルトでは、CIF アドオンは、Adobe Commerce のデフォルトストアとカタログに接続するデフォルト設定でデプロイされます。
この設定は、次の手順に従って、CIF Cloud Service 設定を使用してプロジェクトに合わせて調整できます。
AEM で、ツール/Cloud Services/CIF 設定に移動します。
変更するコマース設定を選択します。
アクションバーから設定プロパティを開きます。
次のプロパティを設定できます。
ほとんどの設定で、デフォルト値 /api/graphql
は変更できません。この設定を変更するのは、指定された GraphQL プロキシを使用しない高度な設定でのみです。
UID のサポートは、Adobe Commerce 2.4.2 で導入されました。コマースバックエンドがバージョン 2.4.2 以降の GraphQL スキーマをサポートしている場合にのみ有効にします。
CIF コアコンポーネントバージョン 2.0.0 以降では、id
のサポートが削除されて uid
に置き換えられました。プロジェクトで CIF コアコンポーネントバージョン 2.0.0 を使用している場合は、カタログ UID のサポートを有効にし、有効なカテゴリ UID を「カタログルートカテゴリ識別子」として使用する必要があります。
上記の設定は参照用です。プロジェクトは、独自の設定を行う必要があります。
複数の AEM サイト構造を異なるコマースカタログと組み合わせて使用する、より複雑な設定については、チュートリアル「コマースマルチストアの設定」を参照してください。