グローバル環境設定ファイル
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
各Commerce Engineのインスタンスには、そのCommerce Engineサービスのグローバル環境構成("Name": "GlobalEnvironment")を定義するGlobal.jsonファイルが含まれています。Commerce Engineサービスが起動すると、Global.jsonファイルの内容はシステムメモリにロードされます。例えば、Global.jsonファイルにはCommerce Engineがグローバルデータベースへの初期接続を行うために使用する接続文字列が含まれており、そこから構成の残りの部分が読み込まれます。
Global.json環境ファイルはC:\inetpub\wwwroot\
以下はサンプルソリューションパッケージの一部として含まれているGlobal.jsonファイルの例Sitecore.Commerce.Engine.SDKを示します。以下に、ファイルの各セクションの内容の説明を示します。
!注あなたのデプロイでは、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`1Sitecore.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`1System.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
`", "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`1System.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`1System.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`1System.String, mscorlib, mscorlib", "$values": "^List-ContentPath.*?$", "^List-ContentItem.*?$", "Entity-Content.*?$", "ContentItem-.*?$", "ContentPath-.*?$"
}, "TableName": "ContentLists" }
} }
グローバル環境の設定ポリシーとパラメータ
Global.jsonファイルは複数のセクションで構成されており、それぞれが関連するポリシープロパティを定義しています。
ManagementCachePolicyプロパティ
ManagementCachePolicyポリシーは、Commerce Control Panel(コンテンツエディタ内)からアイテムモデルオブジェクトのキャッシュを制御Sitecore制御します。
以下の表はManagementCachePolicyポリシーの性質を説明します。
財産
概要
デフォルト値
CurrencySetsCacheName
通貨セットが保管されているキャッシュの名前。
CurrencySets
FulfillmentCacheName
フルフィルメントオプションや種類が保存されているキャッシュの名前。
Fulfillment
PaymentsCacheName
支払いオプションや支払いの種類情報が保存されているキャッシュの名前。
Payments
CountriesCacheName
国や地域が保存されているキャッシュの名前。
Countries
ItemsCollectionCacheName
コンテンツアイテムコレクションが保管されているキャッシュの名前。
ItemsCollection
ItemsCacheName
アイテムが保管されているキャッシュの名前。
Items
Expiration
キャッシュエントリが終了するまでの時間(ミリ秒単位)です。
86400000
AllowCaching
エンティティのキャッシュを有効または無効にします。
true
環境ビジネスツールポリシープロパティ
EnvironmentBusinessToolsPolicyポリシーはBusiness Toolsからアクセス可能な環境を一覧にします。通常、このポリシーはAuthoringサービスを実行している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
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
親ノードの識別。
Hub01
ControllerMethodRolesPolicyプロパティ
ControllerMethodRolesPolicyはCommerce Engine APIへのアクセスを制御します。例えば、どのユーザーがどの操作を実行できるかを判定するために使われます。
Global.jsonファイルは、CommerceOps用とCommerce Engine API用という2つのControllerMethodRolesPolicyポリシーインスタンスを定義しています。
以下の表は、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 Control Panelへのパスを定義するプロパティが含まれています。
以下の表はDefaultContentPathsPolicyポリシーの性質を示しています。
財産
概要
デフォルト値
ContentPaths
Sitecoreのコマースコントロールパネルへのパス。
/sitecore/Commerce/Commerce Control Panel
エンティティShardingPolicyの方針
EntityShardingPolicyには、ContentEntitiesのデータベースシャード名を定義するプロパティが含まれています。
財産
概要
デフォルト値
Expressions
ContentEntitiesのテーブル名に使われる正則表現。
"Entity-Content.*?$"
"Content-.*?$"
"ContentItem-.*?$"
"ContentPath-.*?$"
ListShardingPolicyプロパティ
DefaultContentPathsPolicyには、リストのデータベースシャード名を定義するプロパティContentLists含まれています。
財産
概要
デフォルト値
表現
ContentListsデータベーステーブル名に使われる正規表現。
"^List-ContentPath.*?$"
"^List-ContentItem.*?$"
"Entity-Content.*?
"ContentItem-.*?$"
"ContentPath-.*?$"