close

Filter

loading table of contents...

Connector for HCL Commerce Manual / Version 2101

Table Of Contents

14. Commerce Adapter Properties

wcs.always-use-master-category
Type java.lang.Boolean
Default false
Description

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.

wcs.auth-header-name
Type java.lang.String
Default
Description

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

Default is empty, no Authentication header is used.

wcs.auth-header-value
Type java.lang.String
Default
Description

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

wcs.category-validation-enabled
Type java.lang.Boolean
Default false
Description

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.

wcs.connection-pool-size
Type java.lang.Integer
Default 200
Description

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

wcs.connection-request-timeout
Type java.lang.Integer
Default -1
Description

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".

wcs.connection-timeout
Type java.lang.Integer
Default 10000
Description

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".

wcs.default-locale
Type java.util.Locale
Default  
Description

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

wcs.dynamic-pricing-enabled
Type java.lang.Boolean
Default false
Description

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.

wcs.host
Type java.lang.String
Default shop.wcs.net
Description

The host where the WCS commerce system is installed.

This is a convenience property to be used in conjunction with the Spring profile for version of the WCS commerce system versions to be connected:

  • {@code wcs-8.0}: version-specific configurations for WCS 8.0

  • {@code wcs-9.0}: version-specific configurations for WCS 9.0

  • {@code wcs-9.1}: version-specific configurations for WCS 9.1

In these profiles, the URL paths for the different WCS versions are configured relative to the WCS host.

wcs.network-address-cache-ttl-in-millis
Type java.lang.Integer
Default -1
Description

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".

wcs.password
Type java.lang.String
Default
Description

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

This is mandatory and must be set.

wcs.search-url
Type java.lang.String
Default http://shop.wcs.net:3737/search/resources
Description

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.

wcs.secure-search-url
Type java.lang.String
Default https://shop.wcs.net:3738/search/resources
Description

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.

wcs.secure-url
Type java.lang.String
Default https://shop.wcs.net/wcs/resources
Description

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

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

wcs.socket-timeout
Type java.lang.Integer
Default 30000
Description

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".

wcs.trust-all-ssl-certificates
Type java.lang.Boolean
Default false
Description

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.

wcs.url
Type java.lang.String
Default http://shop.wcs.net/wcs/resources
Description

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

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

wcs.username
Type java.lang.String
Default
Description

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

This is mandatory and must be set.

wcs.version
Type java.lang.String
Default  
Description

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

wcs.cookie.user.filter-pattern
Type java.lang.String
Default WCP?_.+
Description

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.

wcs.cookie.user.filter-pattern-for
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

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 side e.g. `commerce.hub.data.customEntityParams.environment=PREVIEW|LIVE``

IMPORTANT! The keys used here, must match those used on the CM App side via metadata.custom-entity-param-names={environment}

Use this property if the adapter needs to distinguish environments. In this case it is required to set the above mentioned custom entity param.

wcs.cookie.user.user-session-pattern
Type java.lang.String
Default WCP?_USERACTIVITY_(-1002|\d+)
Description

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

wcs.link.asset-url
Type java.lang.String
Default  
Description

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
wcs.link.asset-url-for
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

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 on the CM App side e.g. `commerce.hub.data.customEntityParams.environment=PREVIEW|LIVE`` IMPORTANT: The keys used here, must match those used on the CM App side via metadata.custom-entity-param-names={environment}

Use this property if the adapter needs to distinguish environments. In this case it is required to set the above mentioned custom entity param.

Examples:

wcs.link.asset-url-for.preview=https://shop-preview-hcl.coremedia.vm
wcs.link.asset-url-for.live=https://shop-hcl.coremedia.vm
wcs.link.link-templates
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

Map of {@link com.coremedia.commerce.adapter.base.entities.StorefrontRef} of type {@link com.coremedia.commerce.adapter.base.entities.StorefrontRefType#URL}. 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.wcs.repositories.LinkConstants}:

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#CATEGORY_NON_SEO}. Non-seo-friendly shop URLs to category pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#CATEGORY_SEO}. Used to build seo-friendly URLs to category pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#CONTRACT_PREVIEW}. Used to build a preview url with a contract parameter.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#CHECKOUT_REDIRECT}. Used to build the redirect URL to the checkout page.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#CM_CONTENT}. Used to build seo-friendly URLs to shop pages displaying CoreMedia Articles and Channels.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#EXTERNAL_PAGE_NON_SEO}. Used to build non-seo-friendly URLs to shop pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#EXTERNAL_PAGE_SEO}. Used to build seo-friendly URLs to shop pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#LOGIN}. Used to build the URL to the Login page.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#LOGOUT}. Used to build the URL which logs off the current user.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#PRODUCT_NON_SEO}. Url pattern that is used to build non-seo-friendly shop URLs to product detail pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#PRODUCT_SEO}. Url pattern that is used to build shop URLs for product detail pages.

  • {@link com.coremedia.commerce.adapter.wcs.repositories.LinkConstants#SEARCH_REDIRECT}. Used to build the parameterized search url to be redirected to the shop search result page.

Only lookup keys 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:

  • {storefrontUrl} ... the current store front URL

  • {storeId} ... the current store id

  • {locale} ... the current locale in java format, eg. en_US

  • {language} ... the current language in java format, eg. en

  • {langId} ... the current language as WCS specific id, e.g. "-1" as default language

  • {catalogId} ... the current catalog id

  • {categoryId} ... the current category id

  • {productId} ... the current product id

  • {seoSegment} ... the current seo segment path (can contain path delimiters)

wcs.link.product-max-url-segments
Type java.lang.Integer
Default 3
Description

Max url segments of an seo url for products

wcs.link.storefront-url
Type java.lang.String
Default  
Description

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.

Examles:

https://shop-hcl.coremedia.vm/webapp/wcs/shop
https://shop-preview-hcl.coremedia.vm/webapp/remote/preview/servlet
wcs.link.storefront-url-for
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

Storefront URL prefixes 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 environment is the hardcoded name of the entity param which must be configured on the CM App side e.g. `commerce.hub.data.customEntityParams.environment=PREVIEW|LIVE``

IMPORTANT! The keys used here, must match those used on the CM App side via metadata.custom-entity-param-names={environment}

Use this property if the adapter needs to distinguish environments. In this case it is required to set the above mentioned custom entity param.

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
wcs.link.cm-path-identifier
Type java.lang.String
Default cm
Description

Path token that is used for content pages (shop pages with a CMS seopath as parameter). The default is "cm" with a path like "../cm/cms-seo-path".

metadata.additional-metadata
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

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.

metadata.custom-attributes-format
Type com.coremedia.commerce.adapter.base.entities.CustomAttributesFormat
Default  
Description

Format of the custom attribute values {@link CustomAttributesFormats}.

The keys are always plain strings.

Used to identify the deserialization format on the CMS side.

metadata.custom-entity-param-names
Type java.util.Collection<java.lang.String>
Default  
Description

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

metadata.replacement-tokens
Type java.util.Map<java.lang.String,java.lang.String>
Default  
Description

Map of key value pairs.

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

metadata.supports-multi-catalog
Type java.lang.Boolean
Default false
Description

Flag if commerce adapter implementation supports multiple catalogs.

metadata.vendor
Type java.lang.String
Default  
Description

Name of the vendor.

Used to identify the connected vendor on the CMS side.

Table 14.1. HCL Commerce Adapter related Properties


Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.