Install Bloomreach Accelerator: B2C Commerce
Install the Bloomreach Accelerator: B2C Commerce application using the Bloomreach Accelerator: B2C Commerce Boot project and connect it to your commerce backend platform.
The Bloomreach Accelerator: B2C Commerce Boot project is designed as an out-of-the-box accelerator to integrate your commerce backend with Bloomreach Experience Manager and Bloomreach Discovery.
The Boot project can be configured with a commerce backend platform and Bloomreach Discovery. You can use any of the available commerce backend configurations.
This page explains how to set up the Bloomreach Accelerator: B2C Commerce Boot project in your local development environment, connect your commerce backend platform, and deploy onto a server environment.
Set Up Local Development Environment
The Bloomreach Accelerator: B2C Commerce Boot project is available in the Bloomreach Experience Manager Enterprise Maven repository.
Log in at https://maven.bloomreach.com/.
Point your browser to https://maven.bloomreach.com/#browse/browse:maven2-enterprise:com%2Fbloomreach%2Fcommercedxp%2Fstarterstore-boot.
Pick the appropriate release (version number of the format X.Y.Z) and open the corresponding folder.
Download the starterstore-boot-X.Y.Z-project.tar.gz (or .tar.bz2 or .zip) source distribution and extract it to a folder in your local environment.
Set the connection properties for your commerce backends in conf/hst.properties. Refer to the documentation of each commerce backend configuration for details. Example:
# Bloomreach Accelerator: B2C Commerce parameters for bloomreach backend service. bloomreach.cache.enabled = false bloomreach.account.id = 0000 bloomreach.api.base.url = http://brm-core-0.brsrvr.com/api/v1/core/ bloomreach.domain.key = domain_key_here # Commerce Connector Parameters for ElasticPath Commerce Connector Module. elasticpath.cache.enabled = true elasticpath.baseUrl = http://instance_name.epdemos.com/cortex elasticpath.accessTokenUri = http://instance_name.epdemos.com/cortex/oauth2/tokens elasticpath.username = elasticpath.password = elasticpath.scope = ep_scope elasticpath.role = PUBLIC
Build the application using Maven:
mvn clean verify
Run the application:
mvn -P cargo.run
Verify that the Bloomreach Experience Manager CMS application is accessible at http://localhost:8080/cms/ (login with credentials admin/admin).
To verify that your commerce backend connection is working properly, navigate to the Content perspective and browse to Bloomreach Accelerator: B2C Commerce Boot Project > products. Open one of the example product documents or create a new one, make sure your commerce backend is selected under Commerce Connector, then click Browse under Related External Product. You should be able to browse through the products in your commerce backend.
In future versions, we will support an easier way (e.g, Essentials tools) to migrate existing projects.
Deploy in a Server Environment
The deployment process for the Bloomreach Accelerator: B2C Commerce boot application is the same as for any Bloomreach Experience Manager implementation project.
If you are deploying in Bloomreach Cloud, follow the instructions in Deploy in Bloomreach Cloud.
Otherwise, follow the instructions in Create a Project Distribution and Deploy a Project Distribution.