SAP Commerce Cloud

Last update: April 24, 2024

Topics:
Commerce Integration Framework

CREATED FOR:

Admin
Developer

NOTE

This page contains links to the hybris website. For certain pages, you need an account to log in.

Deploying eCommerce with SAP Commerce Cloud

NOTE

The following procedures use the following demonstration catalog to illustrate the deployment:

Geometrixx Outdoors Site English (US)

Deploying the necessary eCommerce packages provides the full functionality of the eCommerce framework, together with a reference implementation of eCommerce functionality as provided with a hybris implementation (including a demonstration catalog)

This is available under the English (US) branch ( /content/geometrixx-outdoors/en_US) of the Geometrixx Outdoors site:

Product Information (with color variants when appropriate)
Shopping Cart content overviews
Customer Sign-Up and Customer Sign-In
Access to the hybris management console

Technical Requirements - hybris Server

The hybris extension of the eCommerce Integration Framework has been updated to support Hybris 5 (as default), while maintaining backward compatibility with Hybris 4.

NOTE

Supports versions 18.11 and above.
You need Java™ 7 to run the hybris 5 server.
The hybris add-on, the Telco Accelerator, is not supported by the AEM extension.

Packages Needed for eCommerce with hybris

To install eCommerce functionality, you need:

Your hybris server
AEM eCommerce framework:
- this is part of a standard AEM installation
AEM Geometrixx-all package:
- cq-geometrixx-all-pkg
AEM hybris content packages:
- cq-hybris-content-6.3.2
- hybris-specific API implementation
- cq-geometrixx-hybris-content-6.3.2
- a reference implementation to illustrate use of hybris ( geometrixx-outdoors/en_US)

Installation of eCommerce with hybris

To install a fully fledged configuration (using the demonstration catalog, Geometrixx Outdoors) the basic steps are:

Install AEM.
Install the Geometrixx-all package
1. [cq-geometrixx-all-pkg](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq60/product/cq-geometrixx-all-pkg)
Install the demonstration content packages using the Package Manager:
1. [cq-hybris-content-6.3.2](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq630/product/cq-hybris-content)
2. [cq-geometrixx-hybris-content-6.3.2](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq630/product/cq-geometrixx-hybris-content)
Download and build your hybris Server.
Construct your catalog in your eCommerce engine:
1. Set up the Geometrixx Outdoor Store.
Author any supplementary pages that you need in AEM.

CAUTION

Use of the hybris server requires a separate hybris license.

NOTE

For developers, API documentation is also available for download.

Download and Build your hybris Server

The steps in this procedure download and build the hybris server. It also makes the initial configurations that are required for the connections between hybris and cq. The extension is then usable with the default settings.

CAUTION

Hybris versions earlier than 5.5.1 are not supported.

NOTE

To complete this, you need Groovy installed on your system.

Download the hybris Commerce Suite distribution from the hybris download site.

CAUTION
You need an account (from hybris) to access this.
Unzip the distribution file to the required location (referred as <hybris-root-directory>).
From the command line, execute the following:
cd <hybris-root-directory>/bin/platform . ./setantenv.sh ant clean all cd ../..
NOTE
When running:
ant clean all
Press Return when required.
Download the following files to the root folder of your extracted hybris distribution,
<hybris-root-directory>
Get File

NOTE
For hybris 5.6.0 and later, use the following setup.groovy.

5.6.0 and later

Get File
From the command line, execute the following to:
- update the configuration of the hybris server (as required by the extension)
- rebuild the hybris server with the modified configuration
- start the server
groovy setup.groovy cd bin/platform ant clean all sh hybrisserver.sh
NOTE
Dependent on your system, several of these steps might take several minutes to complete.
In your browser, navigate to the hybris administration console at:

http://localhost:9002
Click Initialize and then confirm the initialization action (as it deletes existing data).

The progress is shown on the console, with FINISHED indicating completion.

NOTE
Dependent on your system, this might take several minutes to complete.

Set up the Geometrixx Outdoors Store

This procedure uploads and configures the demonstration store - Geometrixx Online.

Start your hybris instance. From the command line, execute the following:
cd <hybris-root-directory>/bin/platform sh hybrisserver.sh
In your browser, navigate to the hybris management console at:

https://localhost:9002/backoffice

Use these credentials:
- username: admin
- password: nimda
From the sidebar navigation, expand System and Tools. Then select Import to open the Wizard: CSV Import window.
In the Configuration tab, Upload the following Import file:

Get File
Set the Locale Setting to:

en_US - English (United States)
Open the Resources tab.
Upload the following Media-Zip:

Get File
Click Start to import the specified files. The Result tab shows any log entries.
Click Done to close the import window.
From the sidebar, select System, then Tools, then Import.
Upload the following Import file:

Get File

For hybris 5.7, use the following:

Get File
Set the Locale Setting to:

en_US - English (United States)
Click Start to import the specified files. The Result tab shows any log entries.
Click Done to close the import window.
You can now use the product cockpit to view the imported catalogs and products:

http://localhost:9002/productcockpit

recommendation-more-help