Commerce Services Connector
Adobe CommerceとMagento Open Sourceの一部の機能は Commerce Services を利用し、SaaS （software as a service）としてデプロイされます。 これらのサービスを使用するには、実稼動およびサンドボックス API キーを使用して Commerce インスタンスを接続し、configuration でデータ領域を指定する必要があります。 接続はインスタンスごとに 1 回だけ設定する必要があります。
利用可能なサービス availableservices
Commerce Services Connector からアクセスできる Commerce の機能は次のとおりです。
アーキテクチャ
大まかに言えば、Commerce Services Connector は次のコア要素で構成されています。
次のセクションでは、これらの各要素について詳しく説明します。
資格情報 apikey
実稼働およびサンドボックスの API キーは、 ライセンス所有者の Commerce アカウントから生成されます。 Commerce アカウントは、一意の Commerce ID （MageID）で識別されます。 アカウントが有効である限り、販売代理店のライセンス所有者は、Product Recommendationsや Live Search などのサービスの API キーを生成できます。
キーは、ライセンス所有者の代わりにプロジェクトや環境を管理するシステムインテグレーターまたは開発チームと、「必要な情報」ベースで共有できます。 ライセンス所有者から Shared Access を付与された開発者は、マーチャントの組織がアカウントの Switch Accounts ドロップダウンに存在する場合でも、自分の代わりにキーを生成することはできません。
さらに、ソリューションインテグレーターは Commerce Services も使用できます。 ソリューションインテグレーターの場合は、Commerce パートナー契約の署名者が API キーを生成する必要があります。
実稼動およびサンドボックス API キーの生成 genapikey
-
Commerce アカウント（https://account.magento.com）にログインします。
-
「Magento」タブで、サイドバーの API ポータル を選択します。
-
環境 メニューから、「実稼動」または「サンドボックス」を選択します。
-
API キー セクションに名前を入力し、新規追加 をクリックして、新しいキーをダウンロードするためのダイアログを開きます。
note warning WARNING このダイアログでは、キーのコピーまたはダウンロードが必要になる唯一の機会を提供します。 -
「ダウンロード」をクリックし、「キャンセル」をクリックします。
-
各環境（実稼動環境とサンドボックス）で上記の手順を繰り返します。
API キー セクションに API （公開）キーが表示されるようになりました。 ライセンスに関連付けられたいずれかの環境またはインストールで SaaS プロジェクトを選択または作成する場合、4 つのキー（実稼動用キーとサンドボックス用キーの両方、公開鍵と秘密鍵）がすべて必要です。
SaaS 設定 saasenv
Commerce インスタンスは、データを適切な場所に送信できるように、SaaS プロジェクトと SaaS データ領域を使用して設定する必要が Commerce Services ります。 SaaS プロジェクトは、すべての SaaS データ スペースをグループ化します。 SaaS データ スペースは、Commerce Services ーザーが作業できるようにするデータの収集および保存に使用されます。 このデータの一部は Commerce インスタンスから書き出され、一部はストアフロントの買い物客の行動から収集される場合があります。 そのデータは、セキュリティで保護されたクラウドストレージに保持されます。
Product Recommendations えば、SaaS データ スペースには、カタログと行動データが含まれています。 Commerce 設定で 選択することにより、Commerce インスタンスを SaaS データ空間にポイントできます。
これが発生した場合は、 サポートリクエストを送信して、データのクリーンアップをリクエストします。
SaaS データ領域のプロビジョニング
すべてのAdobe Commerce マーチャントは、SaaS プロジェクトごとに 1 つの実稼動データスペースと 2 つのテストデータスペースにアクセスできます。
同じデータスペースを複数の環境で同時に使用しない限り、非実稼動環境でテストデータスペースを使用できます。 別の環境でテストデータ領域を使用するには、その環境でデータ領域を選択および設定する前に、データクリーンアップを実行します。
複数のステージング環境を使用するAdobe Commerce Cloud Pro プロジェクトの場合は、 サポートリクエストを送信することで、ステージング環境ごとに追加のテストデータスペースをリクエストできます。 ただし、ステージング環境が 1 つのみで、追加のテストデータスペースが必要な場合は、次のオプションがあります。
- 追加のステージング環境をリクエストする場合は、カスタマーサクセスチームまたは担当のカスタマーサクセスマネージャーにお問い合わせください。 追加費用がかかります。
- 追加のテストデータスペースの サポートリクエストを送信し、追加のデータスペースに対するビジネス上の正当性を示します。 このリクエストは承認される場合があります。
SaaS プロジェクトの選択または作成 createsaasenv
SaaS プロジェクトを選択または作成するには、ストアの Commerce ライセンス所有者に Commerce API キーをリクエストします。
-
管理者 サイドバーで、システム/サービス/Commerce サービスコネクタ に移動します。
Commerce の設定に Commerce Services Connector のセクションが表示されない場合は、目的の Commerce サービスに Commerce モジュールをインストールします。 また、
magento/module-services-idパッケージがインストールされていることを確認します。 -
Sandbox API Keys セクションと Production API Keys セクションに、キー値を貼り付けます。
- 秘密鍵は、鍵の先頭に
----BEGIN PRIVATE KEY---、鍵の末尾に----END PRIVATE KEY----を含める必要があります。 - 実際のキーのコピーがない場合は、アカウント所有者に問い合わせて、値を設定に接続します。
note warning WARNING データベースのバックアップまたはスナップショットに対してクエリを実行し、その値を設定に貼り付けることでキー値を追加した場合、追加の暗号化レイヤーが適用され、キーは機能しません。 - 秘密鍵は、鍵の先頭に
-
保存 をクリックします。
キーに関連付けられている SaaS プロジェクトは、[SaaS Identifier] セクションの [プロジェクト] フィールドに表示されます。
-
SaaS プロジェクトが存在しない場合は、[プロジェクトの作成] をクリックします。 次に、プロジェクト フィールドに、SaaS プロジェクトの名前を入力します。
-
Commerce ストアの現在の設定に使用する データスペース を選択します。
SaaS プロジェクトまたはデータ領域の名前を変更するには、どちらかの横にある 名前の変更 をクリックします。 名前を変更しても、サービスには影響しません。名前は、プロジェクトとデータ スペースを識別および区別するのに役立つラベルにすぎないからです。
IMS 組織（オプション） organizationid
Adobe Commerce インスタンスをAdobe Experience Platformに接続するには、Adobe IDを使用してAdobeアカウントにログインします。 ログインすると、Adobeアカウントに関連付けられた IMS 組織がこのセクションに表示されます。
SaaS データのエクスポート
Commerce インスタンスが Commerce Services に正常に接続されると、SaaS データ書き出しプロセスによって、Commerce データが Commerce サーバーから Commerce SaaS Services に書き出され、接続されたCommerce Services に同期できるようになります。 管理者では、 データ管理ダッシュボードを使用して、同期ステータスを確認できます。 詳細については、「SaaS データ書き出しガイド」を参照してください。