Sitecore Commerce Engine Connect configuration
The Sitecore.Commerce.Engine.Connect.config
file contains configuration settings that influence the behavior of Commerce Engine (CE) Connect. CE Connect is the connector defined by C# classes that enables the integration between Sitecore Commerce Engine and Sitecore Commerce Connect — the core Sitecore XP commerce framework that exposes API(s) for storefront developers.
The Sitecore.Commerce.Engine.Connect.config
file is stored in your Sitecore service instance (running as Standalone or ContentDelivery or ContentManagement role), in the following location: \inetpub\wwwroot\<Sitecore>\App_Config\Include\Y.Commerce.Engine
.
This topic lists and describes CE Connect configuration settings contained in each section of the Sitecore.Commerce.Engine.Connect.config
file.
The default values listed represent the values that are used when you install and deploy the sample Commerce solution.
Commerce Engine configuration
The <commerceEngineConfiguration>
section in the Sitecore.Commerce.Engine.Connect.config
file provides the following configuration settings:
General CE Connect connector settings
Setting |
Default value |
Description |
---|---|---|
|
|
The URL of the Commerce Engine instance running the Shops service. |
|
|
The URL of the Commerce Engine instance running the Commerce Ops service. |
|
|
The URL of the Commerce Engine instance running the Commerce Minions service. |
|
|
The name of the Commerce Engine Connect client. |
|
|
The hash that is used along with the client ID to authenticate to the Identity Server and get a security token. Connect then uses the token to authenticate to CE. |
|
|
The value (in seconds) used to set the Note The value of the |
|
|
Enforces secure connection using SSL. |
|
|
The Commerce Environment to use by default in HTTP requests (such as |
|
|
Specifies the name of the default minions environment. |
|
|
The default language used when the HTTP request header does not specify a language. |
|
|
The storefront used by default when the HTTP header |
|
|
The default currency used when the HTTP header |
Catalog mappings settings
Setting |
Default value |
Description |
---|---|---|
|
|
The number of IDs to fetch at a time when loading catalog mappings. |
Catalog template fields generator settings
Setting |
Default value |
Description |
---|---|---|
|
|
Controls whether to generate deterministic field identifiers for entities template fields. The Commerce Engine requires this setting to be set to true so that GUIDs are generated using an algorithm based on the path to the field, allowing them to remain the same. |
|
|
Controls whether to generate deterministic field identifiers for component templates. The Commerce Engine requires this setting to be set to true so that GUIDs are generated using an algorithm based on the path to the field, allowing them to remain the same. |
Commerce authoring environment settings
Setting |
Default value |
Description |
---|---|---|
|
|
Specifies which database to use for returning versions of Commerce entities. The Master database contains both published and unpublished versions. The Web database contains published versions of content. |
Indexing settings
Setting |
Default value |
Description |
---|---|---|
|
|
Represents the number of milliseconds to wait before checking the status of the |
|
|
Represents the number of milliseconds to wait before checking the status of the incremental indexing command (a long running process). |
|
|
The number of new or changed items to index that triggers a full cache refresh after incremental indexing. |
CE Connect caching configuration
The <commerceCachingConfiguration>
section in the Sitecore.Commerce.Engine.Connect.config
file contains the following cache settings:
Redis cache settings
Setting |
Default value |
Description |
---|---|---|
|
|
Enabled or disables the Redis cache provider for CE Connect caching. |
|
|
The name of the Redis cache store for the Commerce Connector. |
|
|
The number of seconds between attempts to connect to the Redis cache provider. |
|
| |
|
Redis |
Name of the Redis instance. |
Memory cache settings
Setting |
Default value |
Description |
---|---|---|
|
|
Controls whether to use in-memory caching. |
|
|
Name of the in-memory cache store. |
|
|
Name of the Commerce Connect cache. |
|
|
Number of seconds an item is cached. |
Commands
The following table lists commands that are triggered from the Commerce ribbon, in the Sitecore Content Editor.
Command name |
Description |
---|---|
|
Generates the catalog data templates. Command trigged by the Update Data Templates button. |
|
Deletes the catalog data templates. Command triggered by the Delete Data Templates button. |
|
Clears the following caches in the current Sitecore database (command triggered by the Refresh Commerce Cache button):
|
Pipelines
The CE Connect connector leverages extensibility points provided by the Sitecore pipeline framework to implement Commerce connector functionality. Pipelines that use the prefix commerce in their name are implemented entirely for CE Commerce functionality. Other Sitecore pipelines are extended with custom Commerce processors.
Pipeline / Processor |
Description |
---|---|
|
A CE Connect pipeline processor used to get an EntityView from the Commerce Engine. |
|
A CE Connect pipeline processor used to get a DoAction from a Commerce Engine. |
|
A CE Connect pipeline processor called by Sitecore when displaying a Commerce item in the Content Editor. The processor hides fields from Commerce views based on metadata supplied from the EntityView that corresponds to this content item. For example, fields that are hidden from the Business Tools user interface (UI) should also be hidden when viewing the same item in the Content Editor UI. |
|
Processor added to a Sitecore platform pipeline to set the Content Editor formatter to use |
|
Sitecore processor that determines which commands are enabled for Commerce items. |
|
Processor that extends a Sitecore pipeline to display a warning in the Content Editor if the security token CE Connect sends to the Commerce Engine is invalid or if SSL is not enabled. |
|
Pipeline processor that ensures that the profile cards can be edited for items deriving from relevant Commerce catalog item templates. |
Events
The following table lists events that CE Connect can generate:
Event/Handler/Method |
Description |
---|---|
|
Ensures that Sitecore publishing process does not publish Commerce Catalog Items. Catalog items are published when approved as the end of the approval workflow. |
|
Ensures that the Commerce caches are refreshed upon publishing to the Web. |
|
Removes the changed item from the Sitecore caches. |
|
Clears the Sitecore caches after indexing is completed. |
Hooks
The following hook runs when Sitecore initializes:
Hook |
Description |
---|---|
|
Used to subscribe to the indexing completed event, and associate that event with the |
Settings
The Sitecore configuration is patched to apply the following setting:
Setting |
Description |
---|---|
|
Sitecore setting patched to use |
Services
The following configurator is used to modify Sitecore services collection:
Configurator |
Description |
---|---|
|
Used to modify the Sitecore services collection ( |