Accelerator B2C Commerce Sync Cartridge - Source

The B2C Commerce instance requires a service definition that must be configured to interact with the Mule API.

Uploading the service definition

The following instructions provide guidance on how to import and configure the service definition for a site called RefArch. If your site ID is different, you must edit the endpoints.xml file to adjust the references accordingly.

1. In Business Manager, select Administration > Operations > Import & Export:
   
   
   
   
   
   
2. Click Upload in the 'Import & Export Files' section.
   
   
3. Click Choose File displayed in the 'Upload Import Files' section:
   
   
   
   
4. Locate and select the endpoints.xml definition file in the 'cartridges' source directory.
   
   
5. After you select the import file, click Upload to upload the import file:
   
   
   
   

Importing the service definition

The following instructions describe how to import the service definition leveraged by the Customer Sync Cartridge.

Note: You must first upload the endpoints.xml import file must to Business Manager first,
as described in the previous section.

1. In Business Manager, select Administration > Operations > Import & Export:
   
   
   
   
2. Click Import in the 'Services' section:
   
   
   
   
3. Select the file named endpoints.xml and then click Next:
   
   
   
   
4. After the import process validates the file, confirm that the file has validated without any errors and then click Next to continue:
   
   
   
   
5. On the 'Import' step, select Merge as the import mode and then click Import to process the uploaded file:
   
   
   
   
6. Allow the import file to complete its processing and then confirm that the import has succeeded:
   
   
   
   

Note: The 'Status' section shows the import progress of the file being processed. Click Refresh to update. A successful import has a process status of Success. You can ignore any warnings about "Communication logging" when importing to sandbox environments:

Configuring the Service Definition

The following describes how to configure the service definition for the cartridge so that it can communicate with the B2C Commerce Experience API deployed in CloudHub.

To change the credentials for all deployments:

1. In Business Manager, select Administration > Operations > Services:
   
   
   
   
2. Click the Credentials tab:
   
   
   
   
3. Edit the mule.auth-RefArch service credentials by clicking the credential name.
   
   
4. If your site ID is not RefArch, update the suffix of the credential name and then replace RefArch with your site name.
   
   
5. Use the following properties to configure the credentials for the service:

After the service credentials properties are updated, click Apply to save your changes, and then click the << Back to List button:

Adjusting your SiteId

Use the following instructions if your site ID is not RefArch and you did not edit the endpoints.xml file before importing.

1. Select the Services tab.
   
   
2. Edit the mule.auth-RefArch service definition by clicking on the service name.
   
   
3. Update the suffix of each service name and the log-prefix definition by replacing SiteId with your site name.
   
   
4. Update the suffix of the credential name and replace *SiteId with your site name:
   
   
   
   
5. Repeat steps 2-4 for the mule.rest-RefArch service.

This completes the configuration. There is no need to modify the associated profile-mule profile.