1. 構成

グローバル環境設定ファイル

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

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

Commerce Engineの各インスタンスには、そのCommerce Engineサービスのグローバル環境設定 ("Name": "GlobalEnvironment") を定義するGlobal.jsonファイルが含まれています。Global.jsonファイルの内容は、Commerce Engineサービスの開始時にシステム メモリに読み込まれます。たとえば、Global.jsonファイルには、Commerce Engineが設定の残りの部分の読み込み元となるグローバル データベースへの初期接続を行うために使用する接続文字列が含まれています。

Global.json環境ファイルはC:\inetpub\wwwroot\<CommerceEngine>\wwwroot\bootstrapフォルダにあります。

次に、サンプル ソリューション パッケージSitecore.Commerce.Engine.SDKの一部として含まれているGlobal.jsonファイルの例を示します。ファイルの各セクションの内容の説明は、次のとおりです。

メモ

デプロイメントでは、Global.jsonファイルに対する変更を ポリシー収集セクションに制限する必要があります (例えば、パラメータ値の変更や新しいグローバル構成ポリシーの追加など)。これは、すべてのCommerce Engine環境設定 ファイルに適用されます。

{
  "$type": "Sitecore.Commerce.Core.CommerceEnvironment, Sitecore.Commerce.Core",
  "Id": "GlobalEnvironment",
  "ArtifactStoreId": "{6be385f1-93dc-4299-9dd4-934f6ba42eaa}",
  "IsPersisted": false,
  "Name": "GlobalEnvironment",
  "Policies": {
    "$type":  System.Collections.ObjectModel.ReadOnlyCollection`1[[Sitecore.Commerce.Core.Policy, Sitecore.Commerce.Core]], mscorlib",
    "$values": [
      {
        "$type": "Sitecore.Commerce.Plugin.Management.ManagementCachePolicy, Sitecore.Commerce.Plugin.Management",
        "CurrencySetsCacheName": "CurrencySets",
        "FulfillmentCacheName": "Fulfillment",
        "PaymentsCacheName": "Payments",
        "CountriesCacheName": "Countries",
        "ItemsCollectionCacheName": "ItemsCollection",
        "ItemsCacheName": "Items",
        "Expiration": 86400000,
        "AllowCaching": true
      },
      {
        "$type": "Sitecore.Commerce.Plugin.BusinessUsers.EnvironmentBusinessToolsPolicy,Sitecore.Commerce.Plugin.BusinessUsers",
        "EnvironmentList": {
          "$type": "System.Collections.Generic.List`1[[System.String, mscorlib]], mscorlib",
          "$values": [
            "AdventureWorksShops",
            "AdventureWorksAuthoring",
            "HabitatAuthoring",
            "HabitatShops"
          ]
        }
      },
      { 
        "$type": "Sitecore.Commerce.Plugin.SQL.EntityStoreSqlPolicy, Sitecore.Commerce.Plugin.SQL",
        "PolicyId": "Global",
        "AllowAdmin": true,
        "Database": "PlaceholderForGlobalDatabaseName",
        "EffectiveDate": "0001-01-01T00:00:00",
        "IsVisible": false,
        "Password": "PlaceholderForGlobalDatabasePassword",
        "Server": "PlaceholderForGlobalDatabaseServer",
        "TrustedConnection": false,
        "UserName": "PlaceholderForGlobalDatabaseUserName",
        "View": "EntityStoreSqlPolicy",
        "Version": "10.0.0",
        "AdditionalParameters": "",
        "ConnectTimeout": 20,
        "CommandTimeout": 180,
        "CleanEnvironmentCommandTimeout": 120000
      },
      {
        "$type": "Sitecore.Commerce.Core.DeploymentPolicy, Sitecore.Commerce.Core",
        "DeploymentId": "PlaceholderForDeploymentId",
        "DeploymentVersion": "1.0.0",
        "ParentNodeId": "Hub01"
      },
      {
        "$type": "Sitecore.Commerce.Core.ControllerMethodRolesPolicy, Sitecore.Commerce.Core",
        "ControllerMethodRegularExpression": "/commerceops/",
        "AuthorizedRoles": [
          "sitecore\\Commerce Business User",
          "commerce\\runtime"
        ]
      },
      {
        "$type": "Sitecore.Commerce.Core.ControllerMethodRolesPolicy, Sitecore.Commerce.Core",
        "ControllerMethodRegularExpression": "/api/",
        "AuthorizedRoles": [
          "sitecore\\Commerce Business User",
          "commerce\\runtime"
        ]
      },
      {
        "$type": "Sitecore.Commerce.Plugin.Management.SitecoreConnectionPolicy, Sitecore.Commerce.Plugin.Management",
        "Host": "PlaceholderForSitecoreHost",
        "SitecoreDatabase": "PlaceholderForSitecoreDatabase", 
        "UserName": "PlaceholderForSitecoreUsername",
        "Domain": "PlaceholderForSitecoreDomain",
        "Password": "PlaceholderForSitecorePassword",
        "ConnectionLeaseTimeout": 60000,
        "AuthRequestUrl": "sitecore/api/ssc/auth/login"
        "Protocol": "https",
        "AllowAnonymousUser": "false"
      },
      {
        "$type": "Sitecore.Commerce.Plugin.Content.DefaultContentPathsPolicy, Sitecore.Commerce.Plugin.Content",
        "ContentPaths": {
          "$type": "System.Collections.Generic.List`1[[System.String, mscorlib]], mscorlib",
          "$values": [
            "/sitecore/Commerce/Commerce Control Panel"
          ]
        }
      },
      {
        "$type": "Sitecore.Commerce.Plugin.SQL.EntityShardingPolicy, Sitecore.Commerce.Plugin.SQL",
        "Expressions": {
          "$type": "System.Collections.Generic.List`1[[System.String, mscorlib]], mscorlib",
          "$values": [
            "Entity-Content.*?$",
            "Content-.*?$",
            "ContentItem-.*?$",
            "ContentPath-.*?$"
          ]
        },
        "TableName": "ContentEntities"
      },
      {
        "$type": "Sitecore.Commerce.Plugin.SQL.ListShardingPolicy, Sitecore.Commerce.Plugin.SQL",
        "Expressions": {
          "$type": "System.Collections.Generic.List`1[[System.String, mscorlib]], mscorlib",
          "$values": [
            "^List-ContentPath.*?$",
            "^List-ContentItem.*?$",
            "Entity-Content.*?$",
            "ContentItem-.*?$",
            "ContentPath-.*?$"
          ]
        },
        "TableName": "ContentLists"
      }
    ]
  }
}

グローバル環境の設定ポリシーとパラメータ

Global.jsonファイルは複数のセクションで構成され、それぞれが関連するポリシー プロパティを定義します。

ManagementCachePolicyプロパティ

ManagementCachePolicyポリシーは、Commerceコントロール パネル (Sitecoreコンテンツ エディター) からのアイテム モデル オブジェクトのキャッシュを制御します。

次の表では、ManagementCachePolicyポリシーのプロパティについて説明します。

財産

形容

既定値

CurrencySetsCacheName

通貨セットが格納されるキャッシュの名前。

CurrencySets

FulfillmentCacheName

フルフィルメントのオプションとタイプが格納されているキャッシュの名前。

Fulfillment

PaymentsCacheName

支払いオプションと支払いタイプの情報が格納されるキャッシュの名前。

Payments

CountriesCacheName

国と地域が格納されているキャッシュの名前。

Countries

ItemsCollectionCacheName

コンテンツ項目コレクションが格納されているキャッシュの名前。

ItemsCollection

ItemsCacheName

アイテムが格納されているキャッシュの名前。

Items

Expiration

キャッシュ エントリの有効期限が切れるまでの時間 (ミリ秒単位)。

86400000

AllowCaching

エンティティのキャッシュを有効または無効にします。

true

EnvironmentBusinessToolsPolicyプロパティ

EnvironmentBusinessToolsPolicyポリシーには、Business Toolsからアクセスできる環境が一覧表示されます。通常、このポリシーは、オーサリング サービスを実行しているCommerce Engineのインスタンスで定義されます。

次の表では、EnvironmentBusinessToolsPolicyポリシーのプロパティについて説明します。

財産

形容

既定値

EnvironmentList

ビジネス ユーザーがSitecore Experience Commerce Business Toolsを使用する際にアクセスできる環境を一覧表示します。

  • AdventureWorksShops

  • AdventureWorksAuthoring

  • HabitatAuthoring

  • HabitatShops

EntityStoreSqlPolicyプロパティ

EntityStoreSqlPolicyポリシーは、グローバル・データベース構成を定義します。次の表では、EntityStoreSqlPolicyポリシーのプロパティについて説明します。

財産

形容

既定値

PolicyId

グローバル・データベース構成を制御するポリシーの名前。

Global

AllowAdmin

さまざまなデータベース管理コマンドを許可します。

true

Database

グローバル環境を定義するデータベースの名前。

デフォルトはありません。

この値はデプロイ時に指定されます。

EffectiveDate

データベースが有効になる日付。

001-01-01T00:00:00

Password

グローバル環境データベースのパスワード。

デフォルトはありません。

この値はデプロイ時に指定されます。

Server

グローバル環境データベースサーバ。

デフォルトはありません。

この値はデプロイ時に指定されます。

TrustedConnection

トラステッド接続を使用するかどうかを決定します。

false

UserName

グローバル環境データベースのユーザー名。

デフォルトはありません。

この値はデプロイ時に指定されます。

Version

Sitecore XCの実行バージョン。

10.*.*

AdditionalParameters

追加のパラメータを定義できます。

値は定義されていません。

オプションのパラメータ。

ConnectTimeout

接続が開くのを待つ時間 (秒単位)。

20

CommandTimeout

コマンドの完了を待つ時間 (秒単位)。

180

CleanEnvironmentCommandTimeout

CleanEnvironmentRequest (Postman) が完了するのを待つ時間 (秒単位)。

120000

DeploymentPolicyプロパティ

次の表では、DeploymentPolicyポリシーのプロパティについて説明します。

財産

形容

既定値

DeploymentId

デプロイメントを識別する一意のID。

デフォルトはありません。

この値はデプロイ時に指定されます。

DeploymentVersion

デプロイメントのバージョンを識別します。

1.0.0

ParentNodeId

親ノードのID。

Hub01

ControllerMethodRolesPolicyプロパティ

ControllerMethodRolesPolicyは、Commerce Engine APIへのアクセスを制御します。たとえば、どのユーザーがどの操作を実行できるかを判断するために使用されます。

Global.jsonファイルでは、ControllerMethodRolesPolicyポリシーの2つのインスタンス (1つはCommerceOps用、もう1つはCommerce Engine API用) を定義します。

次の表では、Commerce APIを定義するControllerMethodRolesPolicyポリシーのインスタンスのプロパティについて説明します。

財産

既定値

ControllerMethodRegularExpression

/api/

AuthorizedRoles

sitecore\\Commerce Business User

commerce\\runtime

次の表では、Commerceopsルートを定義するControllerMethodRolesPolicyポリシーのインスタンスのプロパティについて説明します。

財産

既定値

ControllerMethodRegularExpression

/Commerceops/

AuthorizedRoles

sitecore\\Commerce Business User

commerce\\runtime

SitecoreConnectionPolicyプロパティ

SitecoreConnectionPolicyには、Sitecoreホストへの接続を定義するプロパティが含まれています。

次の表では、SitecoreConnectionPolicyポリシーのプロパティについて説明します。

財産

形容

既定値

Host

Sitecoreホストの名前。

デフォルトはありません。

この値はデプロイ時に指定されます。

SitecoreDatabase

Sitecoreマスター データベースの名前。

デフォルトはありません。

この値はデプロイ時に指定されます。

UserName

Sitecoreホストに接続するために必要なユーザー名。

デフォルトはありません。

この値はデプロイ時に指定されます。

Domain

Sitecoreホストのドメイン。

デフォルトはありません。

この値はデプロイ時に指定されます。

Password

認証用のユーザーパスワード。

デフォルトはありません。

この値はデプロイ時に指定されます。

ConnectionLeaseTimeout

Sitecoreホストへのアクティブな接続が閉じられるまでのミリ秒数。

60000

AuthRequestUrl

承認要求のURL。

sitecore/api/ssc/auth/login

Protocol

ホストとの通信に使用されるプロトコル。

https

AllowAnonymousUser

ホストへの接続に認証が必要かどうかを決定します。

false

DefaultContentPathsPolicyプロパティ

このDefaultContentPathsPolicyには、Sitecore Commerceコントロール パネルへのパスを定義するプロパティが含まれています。

次の表では、DefaultContentPathsPolicyポリシーのプロパティについて説明します。

財産

形容

既定値

ContentPaths

Sitecoreのコマース コントロール パネルへのパス。

/sitecore/Commerce/Commerce Control Panel

EntityShardingPolicyポリシー

EntityShardingPolicyには、ContentEntitiesのデータベースシャード名を定義するプロパティが含まれています。

財産

形容

既定値

Expressions

ContentEntitiesテーブル名に使用される正規表現。

"Entity-Content.*?$"

"Content-.*?$"

"ContentItem-.*?$"

"ContentPath-.*?$"

ListShardingPolicyプロパティ

DefaultContentPathsPolicyには、ContentListsリストのデータベースシャード名を定義するプロパティが含まれています。

財産

形容

既定値

式

データベース・テーブル名ContentListsするために使用される正規表現。

"^List-ContentPath.*?$"

"^List-ContentItem.*?$"

"Entity-Content.*?

"ContentItem-.*?$"

"ContentPath-.*?$"

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