AEM/CQ5

Solution : AEM with Silverpop integration

Pre-requisite:

Note:

Silverpop integration is not available out of the box. You must download the Silverpop integration package from Package Share and install it on your instance. After you have installed the package

The integration provides you with the following features:

The ability to create/manage/ Emails in AEM and publish them to Silverpop for distribution.
The ability to set action of a AEM form to create an Silverpop subscriber.

Publishing Newsletters to an Email Service.

After Silverpop Engage is configured, you can publish newsletters or emails to Silverpop Engage. See Publishing Newsletters to an Email Service.

Silverpop configurations can be added via

1. Cloudservices,

2. Tools, or

3. API end points. All methods are described in this section.

To create a Silverpop configuration in Cloud Services:

In AEM, tap or click Tools > Deployment > Cloud Services. (Or directly access at http://:/etc/cloudservices.html.)

Under third-party services, click Silverop Engage and then Configure. The Silverpop configuration window opens.

Enter a title and optionally, a name and click Create. The Silverpop Settings configuration window opens.
Enter the username, password and select an API endpoint from the dropdown list.

Click Connect to Silverpop. When you have successfully connected you see a success dialog. Click OK to exit the window. You can go to Silverpop by clicking Go to Silverpop Engage.

Silverpop has been configured. You can edit the configuration by clicking Edit.

Additionally, Silverpop Engage framework can be configured for personalized actions by providing title and name (optional). Click Create will successfully create the framework for the already configured Silverpop connection.
Imported data extension columns can later be used through the AEM component - Text and Personalization.

To create a Silverpop configuration in Tools:

In AEM, tap or click Tools > Deployment > Cloud Services. Or navigate there directly by going to http://:/misadmin#/etc.

Select Tools, then Cloud Services Configurations, then Silverpop Engage.

Click New to open the Create Page window.

Enter the Title and optionally the Name, and click Create.

Enter the configuration information as outlined in step 4 in the previous procedure. Follow that procedure to finish configuring Silverpop.

To add multiple configurations:

On the welcome page, click Cloud Services and click Silverpop Engage. Click on Show Configurations button which appears if one or more Silverpop configurations is available. All available configurations are listed.

Click the + sign next to Available configurations. This opens the Create Configurations window. Follow the previous configuration procedure to create a new configuration.

Currently, AEM has six unsecured end points (Engage 1 to 6). Silverpop now provides two new end points as well as changed connection end points for the existing ones.
To configure the API end points :

Go to /libs/mcm/silverpop/components/silverpoppage/dialog/items/general/items/apiendpoint/options node on http://:/crxde.

Right-click and select Create, then Create Node.

Enter the Name as sp-e0 and choose Type as cq:Widget.

Add two properties to the newly added node:

Name: text, Type: String, Value: Engage 0
Name: value, Type: String, Value: https://api0.silverpop.com

Click on "Save All" button.

Create one more node with Name as sp-e7 and Type as cq:Widget.
Add two properties to the newly added node:

Name: text, Type: String, Value: Pilot
Name: value, Type: String, Value: https://apipilot.silverpop.com/XMLAPI

To change the existing API End points (Engage 1 to 6), click each of them one-by-one and replace the values as follows:

Node Name	Exisiting End Point Value	New End Point Value
sp-e1	http://api.engage1.silverpop.com/XMLAPI	https://api1.silverpop.com
sp-e2	http://api.engage2.silverpop.com/XMLAPI	https://api2.silverpop.com
sp-e3	http://api.engage3.silverpop.com/XMLAPI	https://api3.silverpop.com
sp-e4	http://api.engage4.silverpop.com/XMLAPI	https://api4.silverpop.com
sp-e5	http://api.engage5.silverpop.com/XMLAPI	https://api5.silverpop.com
sp-e6	http://api.pilot.silverpop.com/XMLAPI	https://api6.silverpop.com

Click Save All. AEM is now ready to connect to Silverpop over secured end points.

Solution:

Hybris Installation

Follow below instruction to insall Hybris environment.

Download JDk 8 from here

Accept licence terms and conitions.
Download as per your windows bit (32 or 64)
Once downloaded, install jdk by double clicking it. Follow the default instructions by clicking next.
Once installed, you should can verify installation in command prompt.
Download the Hybris from here.

Unzip the downloaded zip file to any location in your computer (other than C).
Go inside the folder hybris>bin>platform
Set environment for Ant. (.bat file for windows and .sh for Linux)

Run ant clean all

It will ask for config folder and template, just press enter for default development environment setup.

If you get below error then check ur java version. Hybris 6 supports Java 8.

java.lang.UnsupportedClassVersionError: de/hybris/ant/taskdefs/DbDriverValidator :

 Unsupported major.minor version 52.0

Start Hybris server using command (.bat file for windows and .sh for Linux) in screenshot after you see a build successful message.

It will take some time to start the server. Ideally 10 minutes.

You will see a message syaing, Server startup in ***** ms

Hit http://localhost:9001 from your browser.
Access the above url

make sure Toggle all checkbox is selected.

click on initialize button and confirm the initialization
This will take considerable amount of time based on the system memory and processor as it creates new DB schema, tables and loads the configured data.

Wait till the initialization gets finished as shown in below image.
Click on continue to login page.