Customize and troubleshooting UBX integration

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

Task info

We can create our own command implementation, implement the command interface, and extend from the command implementation to customize UBX integration logic. In your implementation, add our 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