WebSphere Commerce Version 8.0.3.0 or later

Customizing and troubleshooting UBX integration

You can customize UBX integration logic by using the WebSphere Commerce command framework, and you can troubleshoot UBX integration issues by enabling tracing and logging for the feature.

About this task

You can create your own command implementation, implement the command interface, and extend from the command implementation to customize UBX integration logic. In your implementation, add your own logic by overriding the methods.

Procedure

Customize UBX integration logic by working with the following commands:

Main UBX integration commands.

CustomerSegmentUBXIntegrateCmd (CustomerSegmentUBXIntegrateCmdImpl)

This main command for UBX integration. It monitors the UBX jobs and synchronizes customer segment data between WebSphere Commerce and UBX. It is used as a scheduler command, but can also be run as a controller command.

StoreEndpoint

Represents a store's UBX endpoint configuration, and activates the endpoint.
Customer segment import commands.

CreateCustomerSegmentImportCmd (CreateCustomerSegmentImportCmdImpl)

Creates a customer segment customer import scheduled job to import the customer segment customer information as CSV.

CustomerSegmentImportProcess

A subclass of DataLoadProcess to import customer segment data.
Customer segment export commands.

CreateCustomerSegmentExportCmd (CreateCustomerSegmentExportCmdImpl)

Creates a customer segment customer information export scheduled job to export the customer segment customer information into the UPLOADFILE database table.

CustomerSegmentExtractCmd (CustomerSegmentExtractCmdImpl)

Extracts the customer segment customers information and stores the information in the WebSphere Commerce database for later export.

CustomerSegmentUBXUploadCmd (CustomerSegmentUBXUploadCmdImpl)

Reads the extracted customer segment data from the UPLOADFILE database table and calls the UBX REST service to upload the data to UBX.
Customer segment export management commands:

InsertMoreMemberGroupDataCmdImpl

Inserts more data (AllowExport and ExportAll columns of the MBRGRP database table) for the MemberGroup noun.

ChangeMemberGroupPostActionCmdImpl

Updates the AllowExport and ExportAll properties after all the change actions to the member group are complete.

Troubleshoot UBX integration issues:

The following tracing and logging setting can be used to debug UBX integration issues:


*=info: enable.trace.log.*=all: com.ibm.commerce.marketing.*=all:
    com.ibm.commerce.foundation.*=all: com.ibm.commerce.member.*=all

All REST service calls to UBX are logged. Check the REST calls for issues.

For example,


    [timestamp] 00000152 CustomerSegme 1
    com.ibm.commerce.marketing.segment.commands.CustomerSegmentUBXIntegrateCmdImpl
    importCustomerSegments() Calls UBX REST POST Service: 
    https://api-pilot.ubx.ibmmarketingcloud.com/v1/jobs/184603/segmentDataFiles/1606%7C7451%7C3_1_2.segment.output


    [timestamp] 00000152 CustomerSegme 1
    com.ibm.commerce.marketing.segment.commands.CustomerSegmentUBXIntegrateCmdImpl
    importCustomerSegments() UBX REST Servcice Returns: 200