Commerce Engine環境

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore XCソフトウェア アーキテクチャでは、環境の概念 を使用して、さまざまなCommerce Engine設定を可能にします。コマース環境とは、デプロイ要件に基づいて、1つまたは複数のCommerce Engineサービス インスタンスで実行できる、データとサービス機能の個別の構成可能なプールを持つことができることを意味します。クライアントがCommerce Engineを呼び出すときに、呼び出しヘッダーでターゲット環境を指定します。

Commerce Engine環境は、Commerce Engineの動作を制御するポリシーのコレクションによって定義される設定です。環境構成は、エンジンへの呼び出しの処理方法とCommerceデータセットを決定します。したがって、Commerce Engineの機能は、呼び出し元のクライアントの要件に合わせて調整できます。同一のエンジン呼び出し (製品詳細の要求など) は、呼び出しヘッダーで指定されたターゲット環境識別子の構成に応じて、異なる動作をする可能性があります。

たとえば、各Commerce Engineクライアントから予想されるトラフィックのレベルを反映するために、環境間で異なるキャッシュ動作を構成できます。運用環境のデプロイでは、ストアフロント (コンテンツ配信ロール) からの製品の詳細の要求は、通常、Shops環境を対象とし、パフォーマンスへの影響を最小限に抑えるために、データはキャッシュから読み取られる可能性があります。ただし、オーサリング環境を対象とする同じリクエストに応答する場合、Commerce Engineはデータベースから直接データを取得して、最新の情報を提供する可能性があります。

Commerce環境は、環境設定JSONファイルで定義します。環境JSONファイルには、特定のCommerce Engineポリシーに関する情報が、JSONファイル外の ポリシー セット への参照として、またはファイル内の明示的なポリシー設定として含まれており、そのCommerce Engine環境自体にのみ実装されます。

環境設定ファイル

各Commerce環境は、個別の環境コンフィギュレーションJSONファイルで定義されます。

Sitecore XCソリューションには、Sitecore.Commerce.Engine.*.zipパッケージ内のサンプルのHabitatとAdventure Worksのデータセットと環境をサポートするためのいくつかの環境設定ファイルが含まれています。Commerce Engine環境ファイルは、wwwroot\data\Environmentsフォルダに保存されます。サンプル ソリューションには、それぞれHabitat環境とAdventure Works環境用の次の既定の環境ファイルが含まれています。

  • アドベンチャーワークス

    • Plugin.AdventureWorks.CommerceAuthoring-1.0.0.json

    • Plugin.AdventureWorks.CommerceShops-1.0.0.json

    • Plugin.AdventureWorks.CommerceMinions-1.0.0.json

  • 生息地

    • Plugin.Habitat.CommerceAuthoring-1.0.0.json

    • Plugin.Habitat.CommerceShops-1.0.0.json

    • Plugin.Habitat.CommerceMinions-1.0.0.json

各環境JSONファイルには、Commerce Engineの機能とデータセットを関連付ける2つの主要なプロパティが含まれています。

  • 環境名、つまり、Commerce Engineへの呼び出しヘッダーで指定された環境。

  • Commerceデータ セットを指定された環境名にバインドするアーティファクト ストアID値。アーティファクト ストアIDの値は、Commerce EngineがCommerceデータを格納するために使用するキーです。アーティファクト ストアIDは、Commerce Engine (その環境名) への呼び出しが処理するデータのセットを定義します。

例として、次に示すのは、Habitatオーサリング環境 ("Name": HabitatAuthoring") の動作を定義するポリシーを含み、サンプルのHabitatデータセットを表すアーティファクトストアID値に関連付けられたデフォルトのPlugin.Habitat.Commerce-Authoring-1.0.0.jsonファイルのサンプルを示しています。

Example of the ArtifactStoreID and environment Name property in the Plugin.Habitat.CommerceAuthoring environment JSON file.

これらのデフォルトのCommerce Engine環境間の設定の違いは、それぞれの意図された目的を反映しています。

以下は、Commerce Engine環境JSONファイルの "Policies" コレクション内のキャッシングポリシーセットへの参照の例です。

   {
     "$type": "Sitecore.Commerce.Core.PolicySetPolicy, Sitecore.Commerce.Core",
     "PolicySetId": "Entity-PolicySet-CachingPolicySet"
   },

例えば、オーサリング環境の設定では、PromotionsRequireApprovalパラメーター (グローバル・プロモーション・ポリシー内) がfalseに設定されています。これは、通常、ビジネス・ユーザーがこの環境でプロモーションをテストし、プロモーションを公開するための承認を必要としないためです。ただし、ショップ環境では、この同じパラメーターがtrueに設定されているため、ビジネスユーザーは、適切なビジネスユーザー (プロモーションマネージャーロール) の承認なしにプロモーションをストアフロントに公開することはできません。

Configuration file settings

また、独自の環境を作成し 、必要に応じて構成をカスタマイズすることもできます。

メモ

環境のJSONファイルに変更を加えた場合は、Commerce Engineをブートストラップ して、変更がグローバル データベースに反映されるようにする必要があります。

データの分離

環境は、他の環境と同じ永続ストアを共有することも、独自の排他的な永続ストアに分離することもできます。

すべてのCommerce環境には、Commerce EngineがCommerceデータベースにデータを保存するキーであるアーティファクト ストアIDがあります。アーティファクト ストアIDは、(その環境の) Commerce Engineへの呼び出しが処理するデータのセットを定義します。

たとえば、Sitecore Commerce Engine SDKで提供されるSitecore XCソリューションには、2つの異なるサンプル ショップ データセット (HabitatショップとAdventure Worksショップ) のデフォルト環境が含まれています。各データセットには、アーティファクトストアIDが関連付けられています。

サンプルデータセットごとに個別のオーサリング環境とショップ環境が構成されています。

  • HabitatAuthoring - この環境は、Habitatデータセットに対して機能します。オーサリング環境は、Business Toolsからの要求に対するCommerce Engineの動作を定義します。

  • HabitatShops - この環境は、Habitatデータセットに対しても機能します (HabitatAuthoring環境と同じアーティファクト ストアID値を持ちます)。一般的なデプロイメントでは、Shops環境は、ストアフロントから発信されたリクエストに対するCommerce Engineの動作を定義します。

  • AdventureWorksAuthoring - この環境は、Adventure Worksデータセットに対して機能します。一般的なデプロイメントでは、オーサリング環境は、Business Toolsからの要求に対するCommerce Engineの動作を定義します。

  • AdventureWorksShops - この環境は、Adventure Worksデータセットに対しても機能します (AdventureWorksAuthoring環境と同じアーティファクト ストアID値を持ちます)。一般的なデプロイメントでは、Shops環境は、ストアフロントから発信されたリクエストに対するCommerce Engineの動作を定義します。

手記

Sitecore Commerce Engine SDKパッケージに含まれるサンプル ソリューションは、ショップ環境とオーサリング環境で異なる環境ファイルを提供しますが、デフォルトのデプロイでは、実際にはPlugin.Habitat.CommerceAuthoring-1.0.0.jsonファイルで定義された設定のみが使用されます。つまり、デフォルトのデプロイメントでは、SXA StorefrontまたはBusiness Toolsから発信されるCommerce Engineの呼び出しはすべて同じHabitatAuthoring環境を対象としています。

デフォルトのHabitatAuthoring環境とHabitatShops環境は、JSONファイルで宣言されている同じアーティファクト ストアIDを共有します。

The Artifact Store ID in the Commerce Habitat Authoring and Shops environments use the same value.
大事な

異なるCommerce shops環境を使用するように複数のネットショップを構成する場合は、これらのCommerce環境の構成とSitecore.Commerce.Engine.Connect.configファイルで指定された既定の環境の構成がすべて同じアーティファクト ストアID値を使用するようにする必要があります。

この記事を改善するための提案がある場合は、 お知らせください!