--- title: "グローバル環境設定ファイル" slug: "global-environment-configuration-file" abstract: "Commerce Engineのグローバル環境設定を変更する方法。" --- # グローバル環境設定ファイル 各Commerce Engineのインスタンスには、そのCommerce Engineサービスのグローバル環境構成("Name": "GlobalEnvironment")を定義するGlobal.jsonファイルが含まれています。Commerce Engineサービスが起動すると、Global.jsonファイルの内容はシステムメモリにロードされます。例えば、Global.jsonファイルにはCommerce Engineがグローバルデータベースへの初期接続を行うために使用する接続文字列が含まれており、そこから構成の残りの部分が読み込まれます。 Global.json環境ファイルはC:\\inetpub\\wwwroot\\\\wwwroot\\bootstrapフォルダにあります。 以下はサンプルソリューションパッケージの一部として含まれているGlobal.jsonファイルの例Sitecore.Commerce.Engine.SDKを示します。以下に、ファイルの各セクションの内容の説明を示します。 > !注あなたのデプロイでは、Global.jsonファイルの修正を [ポリシーコレクションセクション](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/global-environment-configuration-file.html#UUID-5966678f-e5a8-c455-db6d-f7ce37167821_section-idm4557419577417631537481361847 "Global environment configuration policies and parameters")に限定し、例えばパラメータ値を変更したり、新しいグローバル構成ポリシーを追加したりする必要があります。これはCommerce [Engine環境](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-engine-environments.html "Commerce Engine environments") の構成ファイルに適用されます。 { "$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: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: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](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerceops-api.html "CommerceOps API")用と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-.\*?$"