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 の設定。この URL は、AEM Commerce オーサリングツール（CIF アドオン）および CIF クライアントサイドコンポーネントで使用されます。

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

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

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

Cloud Manager ユーザーインターフェイスを使用（デフォルト）

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

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

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

Adobe I/O CLI を使用

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

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 参照用ストア
• コマースマルチストアの設定
• 複数のコマースシステムの設定