Index Salesforce Commerce Cloud: Push approach via Coveo Cartridge for B2C Commerce

This is for:

Developer System Administrator

This article explains how to push data from a Salesforce Commerce Cloud instance to a Coveo organization. This can be achieved by using the Coveo Cartridge for B2C Commerce (Coveo Cartridge).

The indexed data can be used in a Coveo-powered search interface implemented in your storefront.

Note

Instructions provided in this article apply only if you’re using a Salesforce Commerce Cloud instance (previously known as Demandware).

Prerequisites

Make sure that:

Step 1: Map the fields

To enforce proper indexing, you need to map the product attributes in your Salesforce catalog to the fields in your Coveo organization. To do the mapping, you need to create a mapping file and upload it to your Salesforce instance.

By default, the Coveo Cartridge uses mapping located at the end of the file int_coveo/cartridge/scripts/utils/coveoConstant.js:

// ...
exports.COVEO_FIELD_MAPPER = {
    primaryCategory: {
        custom: {
            sizeChartID: {
                fieldName: 'gender',
                fieldType: 'string'
            }
        }
    },
    name: { 1
        fieldName: 'ec_brand', 2
        fieldType: 'string'
    },
    custom: {
        color: {
            fieldName: 'ec_color',
            fieldType: 'string'
        }
    }
};
1 The SFCC attribute name.
2 The Coveo field ec_brand that’s mapped to the SFCC attribute name.

Update this mapping as required.

Step 2: Upload the cartridges to a site

  1. From within the cartridge folder, run the following command to upload the cartridges to your Salesforce sandbox:

    # this command uploads all cartridges stored in the cartridges archive,
# including the cartridges for SiteGenesis
npm run uploadCartridge

    If you want to upload cartridges only for SFRA, you can do it by running the following commands:

    npm run uploadCartridge bm_coveo
npm run uploadCartridge int_coveo
npm run uploadCartridge int_coveo_sfra
npm run uploadCartridge int_coveo_sfra_changes

  2. In the Business Manager, navigate to Administration → Sites → Manage Sites.

  3. Click the name of the required site.

  4. Switch to the Settings tab.

  5. In the Cartridges field, add the following values at the beginning:

    int_coveo_sfra_changes:int_coveo_sfra:int_coveo

  6. Click the Apply button.

  7. Navigate to Administration → Site Development → Code Deployment.

  8. Select the checkbox to the left of the code version that you specified in the dw.json file. For more info on the dw.json file, refer to the Salesforce documentation.

  9. Click the Activate button to activate the code version.

Step 3: Configure indexing

  1. In the Business Manager, click the Select a Site drop-down menu.

  2. Click the name of the target site.

  3. Navigate to Merchant Tools → Site Preferences → Custom Preferences.

  4. In the ID column, click the Coveo Configs link.

  5. Fill in the fields as follows:

    Name Value

    Coveo Enabled

    Yes

    Coveo Search Enabled

    Yes

    Coveo Chunk Mode Enabled

    Coveo Api Key

    The API key to index the Salesforce catalog and send its data to a source in your Coveo organization. This API key should have the following privileges:

    Service Privilege Access level

    Content

    Sources

    Edit all[1]

    Organization

    Organization

    View

    See Manage API keys and Manage privileges.

    Coveo Search Api Key

    The API key to use on a Salesforce search page.

    This API key should have the following privileges:

    Service Privilege Access level

    Analytics

    Analytics data

    Push

    Search

    Execute queries

    Allowed

    See Use API key authentication with the Search API and Manage privileges.

    Coveo Organization Id

    The ID of your Coveo organization.

    Coveo Source ID

    The ID of a Catalog source in your Coveo organization.

    Coveo Atomic CSS URL

    Don’t fill in this value to use the default URL, https://static.cloud.coveo.com/atomic/v2/themes/coveo.css.

    Coveo Atomic JS URL

    Don’t fill in this value to use the default URL, https://static.cloud.coveo.com/atomic/v2/atomic.esm.js

    Coveo Catalog Last Sync

    The last date and time when the catalog data was indexed. Only the products added on or after this date will be indexed.

    Coveo Search Response Fields

    Add created search fields that you added in your project. For example, ec_rating, ec_color.

    Coveo Search Hub

    The name of the search hub that’s used for the search page.

1. You can also set the Custom access level. Once you set it, you’ll need to select the Edit access level for the targeted push source and the View access level for the other sources.

Step 4: Import the Coveo service, profile, and credentials

The Coveo Cartridge contains an archive with the metadata of the Coveo services, profiles, and credentials that you must use. To import the metadata archive, perform the following steps:

  1. In the Business Manager, navigate to Administration → Site Development → Site Import & Export.

  2. Make sure that the Local option is selected.

  3. Click the Choose File button.

  4. Navigate to the folder where you downloaded the Coveo Cartridge, then to the metadata folder and select the metadata.zip file.

  5. You’ll see a new entry in the table, instance/metadata.zip. Select this entry and click the Import button.

  6. Once the archive is imported, your sandbox will have new entries added in Services, Profiles, and Credentials sections.

    1. Navigate to Administration → Operations → Services and switch to the Services tab. Check that the int.coveo.http.api service is present in the list of services. You don’t need to change the service’s parameters, but make sure they’re as follows:

      A Coveo service added to the Salesforce sandbox

    2. Switch to the Profiles tab. Check that the int.coveo.api.profile entry is present in the list of profiles. You don’t need to change the profile’s parameters, but make sure they’re as follows:

      A Coveo profile added to the Salesforce sandbox

    3. Switch to the Credentials tab. Check that the int.coveo.api.cred entry is present in the list of credentials. Click the int.coveo.api.cred link to open the credential’s details. You don’t need to change the parameters, but make sure they’re as follows:

      The Coveo credentials added to the Salesforce sandbox

      The User and Password fields are default sandbox fields and not used by the Coveo Cartridge, so their values don’t matter.

Step 5: Push the catalog to Coveo

Once the metadata.zip archive is imported, there are two jobs available in your Salesforce sandbox:

  • ProductsFeedExportFull: the job to push the entire catalog to Coveo. It suits the first time when you need to index your catalog.

  • ProductsFeedExportDelta: the job to push only the products that were updated or added after the date set in the Coveo Catalog Last Sync field. See Configure indexing.

To make the jobs operational, do the following:

  1. Navigate to Administration → Operations → Jobs.

  2. Click the required job to open its settings.

  3. Switch to the Job Steps tab.

  4. Next to the Scope label, click the X Sites Assigned button.

  5. In the modal window that appears, select the checkbox to the left of the required site.

    Optional: you may select or clear the checkboxes for other available sites, if required.

  6. Click the Assign button.

  7. While at the job’s settings, you can:

    • Run the job manually by clicking the Run Now button.

    • Schedule the job to run automatically on the Schedule and History tab.