12. Commerce Adapter Properties

Determines that the master category is set on a product. A "master" category must exists in the master catalog and the sales catalog as well. If it is combined with categoryValidationEnabled = true and if the master category cannot be loaded then the next valid category is returned.

If set to "true" the master category is set on products.

The name of an authentication header the REST connector uses the access the WCS REST services.

Default is empty, no Authentication header is used.

The value of an authentication header the REST connector uses the access the WCS REST services.

Determines that only a loadable category is set on a product. All eligible categories are loaded one after the other. The first one that is successful is used.

If set to "true" only a loadable category is set on products.

Maximum number of connections used by the REST connector to access WCS REST services.

The connection request timeout in milliseconds used by the REST connector to access WCS REST services.

That is the time to wait for a response after a connection has been successfully established. A value of "-1" means the client will wait "for ever".

The connection timeout in milliseconds used by the REST connector to access WCS REST services.

That is the time until the server accepts the request. A value of "0" means "infinite".

The default locale the REST connector is using if no locale is given.

Determines if dynamic pricing is enabled.

If set to "true" the PriceRepository tries to get personalized prices from the WCS, otherwise an empty price list is returned.

The time a network address will be cached from the WCS REST Connector.

A value of "-1" means network addresses will be cached "for ever".

The service user password the REST connector uses to login into WCS.

This is mandatory and must be set.

The threshold for response sizes. A warning is logged for responses exceeding the configured size.

Configures the prefix of the HCL Commerce Search profile.

For HCL Commerce 9.0 and older the prefix CoreMedia is used as the default search profile prefix. With HCL Commerce 9.1 the prefix should be set to HCL.

The general WCS URL to access the search-based WCS REST services via http.

If a REST service does not need secure access this url prefix is used.

The secure WCS URL to access the search-based WCS REST services via https.

If a REST service needs secure access this url prefix is used.

The secure WCS URL to access the WCS REST services via https.

If a REST service needs secure access this url prefix is used.

Configures the keys of the facets that that can only be added with a single value to product search requests.

Should e.g. be configured with parentCatgroup_id_search when connecting to WCS 8.0, because it doesn't allow searching with multiple category facets.

The socket timeout in milliseconds used by the REST connector to access WCS REST services.

That is the time to wait for a response after a request has been sent. A value of "0" means "infinite".

Determines if the REST connector accepts any certificates from the WCS.

Note, this value has to be set to "false" in production environments. For internal test systems it is ok bypassing the server authentication.

The general WCS URL to access the WCS REST services via http.

If a REST service does not need secure access this url prefix is used.

The service user the REST connector uses to login into WCS.

This is mandatory and must be set.

The WCS version. Some of the WCS REST services are version specific.

The regular expression pattern for which the client should filter the relevant cookies. This should narrow down the cookies on the client side to a subset of cacheable cookies.

Cookie filter pattern for specific environment. The structure of the Map should be: key=environment, value=cookie pattern. The environment is the hardcoded name of the entity param which must be configured on the CM App client side e.g. `commerce.hub.data.customEntityParams.environment=PREVIEW|LIVE``

Examples:

wcs.link.filter-pattern-for.preview=WCP?_.+

wcs.link.filter-pattern-for.live=WC?_.+

The regular expression pattern for the WCS user session cookie. See description for {@code WC_USERACTIVITY_ID} in:

Asset URL prefix that is used to build asset links to shop images in the live system.

Typically, a proxy url is set including protocol and possibly a context path prefix.

Should only be set if the adapter does not need to distinguish environments. In this case no environment metadata.custom-entity-param-names parameter is required.

Examles:

https://shop-hcl.coremedia.vm

https://shop-preview-hcl.coremedia.vm

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Asset URL prefixes which are used to build asset links to shop images for different environments.

Typically, a proxy url is set including protocol and possibly a context path prefix. The structure of the Map should be: {key=environment, value=url}. The environment is the hardcoded name of the entity param which must be configured in the CMS app, e.g. commerce.hub.data.custom-entity-params.environment=preview|live. IMPORTANT: The keys used here must match those used in the CMS app via commerce.hub.data.customEntityParams.environment={environment}.

Examples:

wcs.link.asset-url-for.preview=https://shop-preview-hcl.coremedia.vm

wcs.link.asset-url-for.live=https://shop-hcl.coremedia.vm

For configuration options see also documentation of wcs.link.storefront-url-for.

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Map of {@link com.coremedia.commerce.adapter.base.entities.links.StorefrontRef}. Used to build shop urls for the Studio Preview and Content-Led integration scenarios.

Known default lookup keys are defined in {@link com.coremedia.commerce.adapter.base.entities.links.StorefrontRefKeysCommerceLed} and {@link com.coremedia.commerce.adapter.base.entities.links.StorefrontRefKeysContentLed}: Commerce-led Links:

Content-led Links:

Only lookup keys in lowercase and without "_" are valid.

These patterns can include tokens which will be replaced. These tokens must be well known. The following tokens are predefined:

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Max url segments of an seo url for products

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Storefront URL prefix that is used to build storefront links to shop pages and resources in the live system.

Typically, a proxy url is set, including protocol and possibly a context path prefix.

Should only be set if the adapter does not need to distinguish environments In this case no environment metadata.custom-entity-param-names parameter is required.

Examples:

https://shop-hcl.coremedia.vm/webapp/wcs/shop

https://shop-preview-hcl.coremedia.vm/webapp/remote/preview/servlet

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Storefront URLs which are used to build storefront links to shop pages and resources for different environments. The structure of the Map should be: {key=environment, value=url}.

The multi environment support needs to be activated via metadata.custom-entity-param-names=environment.

Examples:

wcs.link.storefront-url-for.preview=https://shop-preview-hcl.coremedia.vm/webapp/remote/preview/servlet

wcs.link.storefront-url-for.live=https://shop-hcl.coremedia.vm/webapp/wcs/shop

The environment name for the custom entity param must be configured on the client side (CAE, Studio, etc.). Global configuration example: commerce.hub.data.customEntityParams.environment=preview|live

You may also configure multiple storefront URLs for different sites/environments via the commerce settings struct: commerce (Struct) customEntityParams (Struct) environment=siteus (String) Keep the lookup keys simple. Use lowercase with no special characters.

Be aware that you need to configure the environment values on the client site first, otherwise lookups can't work and will fail. There is no default fallback as this could lead to even more confusion.

This and the further wcs.link properties are not needed when only connecting to HCL Commerce 9.1+ React stores.

Number of cache entries per cache class until cache eviction takes place. The keys must match the cache classes as defined by the cache keys. Please refer to javadoc of com.coremedia.cache.CacheKey.

TTL in seconds until certain cache entries are invalidated.

Whether or not to recompute entities proactively on invalidation.

Whether or not to propagate invalidations of entities to the clients.

Map of additional metadata.

Can be used as customization hook. All properties starting with "metadata.additional-metadata.*" are transmitted to the generic client on the CMS side.

Format of the custom attribute values.

The keys are always plain strings.

Used to identify the deserialization format on the CMS side.

List of parameter names, which values need to be transmitted with every entity request from the CMS side.

Map of key value pairs.

Used as replacement map for example for link building in the generic client on the CMS side.

Name of the vendor.

Used to identify the connected vendor on the CMS side.