Home
Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
Tutorials
HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
Programming model
HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to creating customized code to develop and enhance HCL Commerce applications. The following tutorials provide sample guides to customizing elements of the HCL Commerce programming model.
Custom caches
Custom caches improve performance of customizations by enabling the re-use of logic and data. Caches are defined in the WebSphere configuration and accessed thru standard DynaCache APIs. Custom caches can take full advantage of the HCL Cache framework for caching locally and remotely in Redis.
Configuring HCL Cache options
Custom caches using the default hcl-cache provider can be configured with additional options.

Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
- Getting started
  HCL Commerce has different advantages for business users, administrators and developers. HCL Commerce targets each of these roles with a tailored set of offerings so that each of your users can get maximum benefit.
- Installing and deploying
  Learn how to install and deploy HCL Commerce development environments and HCL Commerce production environments.
- Migrating
  Before you migrate to HCL Commerce Version 9.1, review this information to help plan and execute your migration.
- Operating
  Topics in the Operating category highlight tasks that are typically performed by business users, customer support representatives, to complete their day-to-day tasks in the operation of the HCL Commerce site.
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
- Administering
  Topics in the Administering category highlight tasks that are typically performed by the Site Administrator, to support daily operations of the HCL Commerce site.
- Customizing
  The topics in the Customizing section describe tasks performed by an application developer to customize HCL Commerce.
- Tutorials
  HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
  - Docker start-up logic
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to the customizing Docker start-up logic. The following tutorials provide sample guides to defining the custom logic.
  - Programming model
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to creating customized code to develop and enhance HCL Commerce applications. The following tutorials provide sample guides to customizing elements of the HCL Commerce programming model.
    - Modifying a controller command
      This tutorial demonstrates how to modify an existing controller command. In this tutorial, you restrict the number of items in a customer's shopping cart to five or fewer unique items. To implement this solution, you override the OrderItemAddCmdImpl class with your own implementation. The implementation includes logic to check for the number of items in the shopping cart. If a customer attempts to add a sixth item to the shopping cart, an exception is thrown. This exception uses a new error message.
    - Custom caches
      Custom caches improve performance of customizations by enabling the re-use of logic and data. Caches are defined in the WebSphere configuration and accessed thru standard DynaCache APIs. Custom caches can take full advantage of the HCL Cache framework for caching locally and remotely in Redis.
      - Defining custom caches in the WebSphere Application Server configuration
        To be able to use DynaCache APIs to operate a cache, the cache first needs to be declared in the WebSphere Application Server configuration.
      - Configuring HCL Cache options
        Custom caches using the default hcl-cache provider can be configured with additional options.
      - Using DynaCache APIs to operate the cache
        HCL Commerce extensions can interface with the cache by using the DistributedMap interface. The interface provides methods for operations such as put, get, clear and invalidate.
  - Web services
    Web services tutorials introduce the various tasks that are related to creating and customizing web services for HCL Commerce applications.
  - Management Center
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to customizing Management Center.
  - Migration
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to migration from previous versions of WebSphere Commerce. The following tutorials provide sample guides to migrating your WebSphere Commerce sites to HCL Commerce Version 9.1.
  - Search
    HCL Commerce provides tutorials that are designed to describe how to customize HCL Commerce Search.
  - Starter stores
    HCL Commerce provides tutorials that are designed to introduce the various tasks that are related to customizing the storefront.
- Samples
  Topics in the Samples category highlight the various samples that are provided with HCL Commerce.
- Compliance
  The following section describes how you can leverage HCL Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of HCL Commerce and how to configure these features.
- Performance
  Topics in the Performance section describe the means by which to plan, implement, test, and re-visit the optimization of HCL Commerce site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with HCL Commerce, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the HCL Commerce reference documentation.

HCL Commerce Version 9.1.9.0

Configuring HCL Cache options

Custom caches using the default hcl-cache provider can be configured with additional options.

HCL Caches enable local and remote caching by default. Custom caches can also be configured to use only local, or only remote configurations.

Local-only cache: Use local-only caches for objects that are not serializable. Local-only caching can also be preferred for objects that grow unbounded and have poor re-usability, such as search results. By using only local caching you avoid the additional overhead for network and memory maintenance incurred by remote caching.
Remote-only cache: Remote-only caches are only stored in the remote Redis server and do not require invalidations to be replicated to each local server. This can be preferable for frequently changing data, where high volumes of invalidation messages can sometimes cause stale cached data to be used due to slower message processing.

When local caching is used, the HCL Cache automatically enables publish and subscribe of invalidation messages.

configuration are defined in the HCL Cache configuration map as in the following example:

<?xml version="1.0" encoding="UTF-8"?>

<server>
apiVersion: v1
data:
  cache_cfg-ext.yaml: |-
    # cache_cfg-ext.yaml content read from values
    redis:
      enabled: true
      yamlConfig: "/SETUP/hcl-cache/redis_cfg.yaml" # Please leave this line untouched
      circuitBreaker:
        scope: client	
    cacheConfigs:
      services/cache/MyRemoteOnlyCustomCache1:
        localCache:
          enabled: false
      services/cache/MyLocalOnlyCustomCache1:
        remoteCache:
          enabled: false

HCL Cache also allows each cache entry to optionally specify that it should not be cached either in the local cache or in the remote cache. If the cache id contains “hcl-cache:skip-remote”, then the entry will not be cached in the remote cache. Similarly, if the cache id contains “hcl-cache:skip-local”, then the entry will not be cached in the local cache.

For use in DynaCache cachespec.xml configuration files, these special strings are available as HTTP request attributes, named DC_HclCacheSkipRemote and DC_HclCacheSkipLocal respectively. They can be used to help construct cache ids in the cachespec.xml file, like this:

<component id=”DC_HclCacheSkipRemote” type=”attribute”>
<required>true</required>
</component>