IBM Websphere: Monetate Implementation - SLIDEBLAST.COM

•

IBM Websphere: Monetate Implementation Installation Guide

Revised: 4/29/15

Table of Contents Assets

1

Integration

2

Job Integration

2

Database changes

2

WC project changes

3

LOBTools project changes

3

Tracking code integration

5

Stores project changes

5

Snippets

5

Validation

7

Default IBM Websphere/Monetate Configuration Please note, the IBM Websphere connector is provided based on a default configuration for platforms in the United States; however, this configuration can be customized via open source code by a systems integrator (SI). The open source feature allows for maximum flexibility with the core connector code. Monetate can provide recommendations for an integrator if you prefer. If you prefer, Monetate also provides an API in addition to the connector. The connector provides a standard implementation of the API for this platform with the ability to customize.


 Assets The Monetate integration package is provided as a compressed zip file (sysiq-commerce-monetate-logicassets.zip). It contains the assets needed to integrate support for Websphere Commerce Feature Pack 7 Aurora Store in Monetate. The folder structure of the file reflects the default directories and files which can be found in Aurora Store (with the exception of the dataload directory). The file contains following top level directories:

Directory

Assets

dataload

Contains sql scripts and acp load files

LOBTools

Contains files for Management Center project. Reflects Management project structure.

Stores

Contains files for the Stores project and reflects the Stores project structure

WC

Contains files for WC project. Reflects WC project structure

1

Feed and Tag Integration Please note, feed and tag integrations are independent of each other and one is not needed for the other to function.

Integration The integration process consists of following steps:

Step Job Integration

Features Requires changes to the database, LOBTools, Stores, and WC projects

Tracking Code Integration

Requires changes to the Stores project

Job Integration Database changes 1.

Replace in sysiq-commerce-monetate-logic-assets/dataload/sql/MC_Integration.sql with your real store ID. Your Store ID can be found by performing the sql query: SELECT * FROM STOREENT

2.

Replace in sysiq-commerce-monetate-logic-assets/dataload/sql/ Register_Products_Feed_Job.sql with the real ID from database. You can take next ID from table schcmd for this purpose. SELECT MAX(SCHCMD_ID)+1 from SCHCMD

3.

Execute sysiq-commerce-monetate-logic-assets/dataload/sql/Register_Products_Feed_Job.sql and sysiqcommerce-monetate-logic-assets/dataload/sql/MC_Integration.sql on the selected DB.

4.

Request your Monetate tag from the Monetate Support team and add this tag to the database. You need also specify correct store ID. A query example can be found here: sysiq-commerce-monetate-logicassets\dataload\sql\AddMonetateTag.sql.

5.

Apply the ACP policy for the job command. Run the acpload utility with the sysiq-commerce-monetatelogic-assets/dataload/acp/MonetateACPolicy.xml file (acpload utility description)

1

WC project changes Copy job jars from sysiq-commerce-monetate-logic-assets/WC/lib to the corresponding directory in your project workspace. For example: C:\IBM\WCDE_ENT70\workspace\WC\lib)

Stores project changes 1.

Register the job in struts-config-ext.xml. Paste the snippet below in the element in C: \IBM\WCDE_ENT70\workspace\Stores\WebContent\WEB-INF\struts-config-ext.xml. The snippet is present in sysiq-commerce-monetate-logic-assets/Stores/WebContent/WEB-INF/struts-config-ext.xml.snippet in the "Job registration" section.

2.

Modify and paste sysiq-commerce-monetate-logic-assets/Stores/src/src/com/sysiq/commerce/monetate/ config.properties in the corresponding place in your workspace. For example: C:\IBM \WCDE_ENT70\workspace\Stores\src\com\sysiq\commerce\monetate\config.properties).

Note: Definitions for the config parameters are described in config.properties comments.

LOBTools project changes 1.

Paste the properties files sysiq-commerce-monetate-logic-assets/LOBTools/src/com/sysiq/commerce/store/ client/lobtools/properties in the corresponding place in your workspace. For example: C:\IBM \WCDE_ENT70\workspace\LOBTools\src\com\sysiq\commerce\store\client\lobtools\properties.

2.

Review the integration steps in sysiq-commerce-monetate-logic-assets/LOBTools/WebContent/config/ commerce/store/propertiesViews/Aurora/StoreFlexFlowPropertiesView.def.snippet for information about adding the Monetate tab to your store properties. Please refer to sysiq-commerce-monetate-logic-assets/ LOBTools/WebContent/config/commerce/store/propertiesViews/Aurora/StoreFlexFlowPropertiesView.def for an example with these modifications.

1

3.

Review the integration steps in sysiq-commerce-monetate-logic-assets/LOBTools/WebContent/config/ commerce/store/objectDefinitions/StorePrimaryObjectDefinition.def.snippet for adding object definitions to your support tag configuration in the Management Center. You can refer to sysiq-commercemonetate-logic-assets/LOBTools/WebContent/config/commerce/store/objectDefinitions/ StorePrimaryObjectDefinition.def for an axample with these modifications.

4.

Paste sysiq-commerce-monetate-logic-assets/LOBTools/WebContent/jsp/monetate/MonetateConfig-Get.jsp into the LOBTools project in the corresponding place in your workspace.

5.

Add struts actions to your project. Review the required changes in sysiq-commerce-monetate-logicassets/LOBTools/WebContent/WEB-INF/struts-extension.xml.snippet and update the struts actions for the LOBTools project in your workspace. You can find an example can in the file sysiq-commerce-monetatelogic-assets/LOBTools/WebContent/WEB-INF/struts-extension.xml.

6.

Disable cross-site scripting for the Management Center. Modify web.xml for your LOBTools project according to the changes present in sysiq-commerce-monetate-logic-assets/LOBTools/WebContent/WEBINF/web.xml.snippet.

1

Tracking code integration Stores project changes 1.

Copy sysiq-commerce-monetate-logic-assets/Stores/WebContent/Aurora/Widgets/Monetate and sysiqcommerce-monetate-logic-assets/Stores/WebContent/Aurora/javascript/Widgets/Monetate to corresponding locations in workspace.

2.

Register the shopcart view struts-config-ext.xml. Copy the snippet "Track shopping cart view registration” in sysiq-commerce-monetate-logic-assets/Stores/WebContent/WEB-INF/struts-configext.xml.snippet to struts-config-ext.xml file in your workspace. For example: C:\IBM \WCDE_ENT70\workspace\Stores\WebContent\WEB-INF\struts-config-ext.xml. Don't forget to replace with your real store ID.

3.

Copy and paste the Monetate code from sysiq-commerce-monetate-logic-assets/Stores/WebContent to the corresponding locations in your workspace. Each snippet begins with