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
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