Configuring the Commerce Adapter

The physical connection to the HCL Commerce Server system is configured in the Commerce Adapter. The Commerce Adapter itself communicates via REST API calls with the HCL Commerce Server system.

The Commerce Adapter comes along with a set of configuration properties. For detailed documentation and defaults see Chapter 12, Commerce Adapter Properties.

The commerce-adapter-wcs provides Spring profiles for the different HCL Commerce Server versions that are supported. These profiles configure the suitable URLs that are required to connect to the HCL Commerce Server. To use these profiles, set the wcs.host property and activate the Spring profile wcs-[VERSION] when starting the adapter application.

Starting the Commerce Adapter

This guide describes how to build and run the commerce-adapter-wcs Docker container.

Prerequisites to be installed:

CoreMedia provides a Docker setup for the HCL Commerce Connector. It is part of a dedicated CoreMedia HCL Commerce Connector Contributions Repository.

After cloning the workspace, a coremedia/commerce-adapter-wcs Docker image can be build via mvn clean install command.

To run the commerce-adapter-wcs Docker container, the configuration properties for the adapter must be set (see above). Spring Boot offers several ways to set the configuration properties, see Spring Boot Reference Guide - Externalized Configuration. When starting the Docker container, this will probably lead to setting either environment variables (using the Docker option --env or --env-file) or mounting a configuration file (using the Docker option --volume).

The Docker container can be started with the command

docker run \
  --detach \
  --rm \
  --name commerce-adapter-wcs \
  --publish 44365:6565 \
  --publish 44381:8081 \
  [--env ...|--env-file ...|--volume] \
  coremedia/commerce-adapter-wcs:${ADAPTER_VERSION}

To run the commerce-adapter-wcs Docker container with the CoreMedia CMCC Docker environment, add the commerce-adapter-wcs.yml compose file that is provided with the CoreMedia Blueprint Workspace to the COMPOSE_FILE variable in the Docker Compose .env file. Ensure that the environment variables that are passed to the Docker container are also defined in the .env file:

COMPOSE_FILE=compose/default.yml:compose/commerce-adapter-wcs.yml
WCS_HOST=...
...

The commerce-adapter-wcs container is started with the CoreMedia CMCC Docker environment when running

docker compose up --detach

Detailed information about how to set up the CoreMedia CMCC Docker environment can be found in Chapter 2, Docker Setup in Deployment Manual.

Note

For HCL Commerce 9.1, it is recommended to use the following search profile prefix:

• HCL for the headless integration with elasticsearch-based search
• IBM for the headless integration with solr-based search

For earlier HCL Commerce versions, it is recommended to use the default search profile prefix CoreMedia.