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 コマースオーサリングツール（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 UI 経由（デフォルト）

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

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

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

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 のサポートを有効にします。
  メモ

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

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

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

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

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

その他のリソース

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