Install Bloomreach Accelerator: B2C Commerce

Introduction

Goal

Install the Bloomreach Accelerator: B2C Commerce application using the Bloomreach Accelerator: B2C Commerce Boot project and connect it to your commerce backend platform.

Background

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.

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.