AEM Commerce as a Cloud Service - はじめに

AEM Commerce as a Cloud Service の使用を開始するには、Experience Manager Cloud Service が Commerce Integration Framework（CIF）アドオンによりプロビジョニングされている必要があります。CIF アドオンは、AEM Sites as a Cloud Service の追加モジュールです。

オンボーディング

AEM Commerce as a Cloud Service のオンボーディングは、次の 2 つの手順で構成されます。

1. AEM Commerce as a Cloud Service を有効にし、CIF アドオンをプロビジョニングする
2. AEM Commerce as a Cloud Service をコマースソリューションに接続する

最初のオンボーディング手順はアドビが行います。価格とプロビジョニングの詳細については、セールス担当者にお問い合わせください。

CIF アドオンのプロビジョニングが完了すると、既存の Cloud Manager プログラムに適用されます。Cloud Manager プログラムがない場合は、新しく作成する必要があります。詳しくは、「プログラムの設定」を参照してください。

2 つ目の手順は、各 AEM as a Cloud Service 環境のセルフサービスです。CIF アドオンの初期プロビジョニングの後で、いくつかの追加の設定を行う必要があります。

AEM とコマースソリューションの接続

CIF アドオンと AEM CIF コアコンポーネントをコマースソリューションに接続するには、Cloud Manager の環境変数で GraphQL エンドポイント URL を指定する必要があります。変数名は COMMERCE_ENDPOINT です。HTTPS を介した安全な接続を設定する必要があります。

この環境変数は、次の 2 つの場所で使用されます。

• AEM CIF コアコンポーネントと顧客プロジェクトコンポーネントで使用される、共有可能な共通の GraphQl クライアントを介した、AEM からコマースバックエンドへの GraphQL 呼び出し。
• /api/graphql で変数が使用可能に設定された各 AEM 環境への GraphQL プロキシ URL の設定。これは、AEM Commerce オーサリングツール（CIF アドオン）および CIF クライアントサイドコンポーネントで使用されます。

AEM as a Cloud Service 環境ごとに異なる GraphQL エンドポイント URL を使用できます。この方法で、プロジェクトは AEM ステージング環境をコマースステージングシステムに、また、AEM 実稼働環境をコマース実稼働システムに接続できます。GraphQL エンドポイントは、公開されている必要があります。プライベート VPN またはローカル接続はサポートされていません。オプションで、認証が必要な追加の CIF 機能を使用するために認証ヘッダーを指定できます。

Adobe Commerce Enterprise／Cloud の場合のみ、CIF アドオンはオプションで AEM 作成者向けのステージング済みカタログデータの使用をサポートします。これには、Authorization ヘッダーを設定する必要があります。このヘッダーは、セキュリティ上の理由から、AEM オーサーインスタンスでのみ使用できます。AEM パブリッシュインスタンスでは、ステージング済みデータを表示できません。

エンドポイントを設定する方法は 2 つあります。

Cloud Manager UI 経由（デフォルト）

これは、環境の詳細ページのダイアログを使用して行うことができます。コマース対応プログラムでこのページを表示すると、エンドポイントが設定されていない場合は、ボタンが表示されます。

このボタンをクリックすると、次のダイアログが開きます。

エンドポイント（およびオプションでステージング済みカタログのサポートの Authorization ヘッダー）が設定されると、エンドポイントが詳細ページに表示されます。編集アイコンをクリックすると同じダイアログが開き、必要に応じてエンドポイントを変更できます。

Adobe I/O CLI 経由

AEM を Adobe I/O CLI を介してコマースソリューションに接続するには、次の手順に従います。

1. Cloud Manager プラグインと Adobe I/O CLI を取得します。

   Cloud Manager CLI プラグイン で Adobe I/O CLI をダウンロード、設定、使用する方法については、 Adobe Cloud Manager のドキュメント を参照してください。

2. Adobe I/O CLI を AEM as a Cloud Service で認証します。

3. Cloud Manager で COMMERCE_ENDPOINT 変数を設定します。

   aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
   

   詳細は、 CLI ドキュメント を参照してください。

   コマース GraphQL エンドポイント URL は、コマースの GraphQL サービスを指し、安全な HTTPS 接続を使用する必要があります。例：https://<yourcommercesystem>/graphql

4. 認証を必要とするステージング済みカタログ機能を有効にする（オプション）

   メモ

   この機能は、Adobe Commerce Enterprise または Cloud Edition でのみ使用できます。詳しくは、トークンベースの認証を参照してください。

   Cloud Manager でシークレット変数 COMMERCE_AUTH_HEADER を設定します。

   aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
   

これで、AEM Commerce as a Cloud Service を使用する準備が整い、Cloud Manager を介してプロジェクトをデプロイできます。

ストアとカタログの設定

CIF アドオンと CIF コアコンポーネントは、異なるコマースストア（またはストアビューなど）に接続された複数の AEM サイト構造で使用できます。デフォルトでは、CIF アドオンは、Adobe Commerce のデフォルトのストアとカタログ（）に接続するデフォルト設定でデプロイされます。

この設定は、次の手順に従って、CIF Cloud Service 設定を使用してプロジェクトに合わせて調整できます。

1. AEM で、ツール／Cloud Services／CIF 設定に移動します。

2. 変更するコマース設定を選択します。

3. アクションバーから設定プロパティを開きます。

次のプロパティを設定できます。

• GraphQL クライアント - コマースバックエンド通信用に設定済みの GraphQL クライアントを選択します。これは通常、デフォルトのままです。
• ストア表示 - ストア表示の識別子。空の場合は、デフォルトのストア表示が使用されます。
• GraphQL プロキシパス - AEM の GraphQL プロキシが、コマースバックエンドの GraphQL エンドポイントへのリクエストをプロキシするために使用する URL パス。
  メモ

  ほとんどの設定で、デフォルト値 /api/graphql は変更できません。この設定を変更するのは、指定された GraphQL プロキシを使用しない高度な設定でのみです。

  - カタログ UID のサポートを有効にする - コマースバックエンドの GraphQL 呼び出しで、ID ではなく UID のサポートを有効にします。
  メモ

  UID のサポートは、Adobe Commerce 2.4.2 で導入されました。コマースバックエンドがバージョン 2.4.2 以降の GraphQL スキーマをサポートしている場合にのみ有効にします。

  - カタログのルートカテゴリ識別子 - ストアカタログルートの識別子（UID または ID）
  注意

  CIF コアコンポーネントバージョン 2.0.0 以降では、id のサポートが削除されて uid に置き換えられました。プロジェクトで CIF コアコンポーネントバージョン 2.0.0 を使用している場合は、カタログ UID のサポートを有効にし、有効なカテゴリ UID を「カタログルートカテゴリ識別子」として使用する必要があります。

上記の設定は参照用です。プロジェクトは、独自の設定を行う必要があります。

複数の AEM サイト構造を異なるコマースカタログと組み合わせて使用する、より複雑な設定については、チュートリアル「コマースマルチストアの設定」を参照してください。

その他のリソース

• AEM プロジェクトアーキタイプ
• AEM Venia 参照用ストア
• コマースマルチストアの設定
• 複数のコマースシステムの設定

Business.Adobe.com リソース