Setting Up Your Salesforce Commerce Cloud Connector

Please note that this Connector is a paid product. For pricing information, please reach out to your Smartling Customer Success Manager.

Ensure you have read our documentation on Required Configuration To Connect The Salesforce Commerce Cloud Connector, before continuing. This article takes you through the process of using the required configuration in Salesforce to set up the Salesforce Commerce Cloud Connector.

Connecting Salesforce Commerce Cloud to Smartling

1. Log into Smartling
2. Create a Salesforce Commerce Cloud Connector project type in your Smartling Account
   • Ensure all required target languages are added to this project
3. From within this project, click Settings > Salesforce Commerce Cloud Settings
4. Click Connect to Salesforce Commerce Cloud
5. Insert the required configuration values
6. Click Save

Your Salesforce Commerce Cloud instance is now connected to Smartling. Next, configure the Connector.

Salesforce Commerce Cloud Connector Configuration

When you have successfully completed connecting Salesforce Commerce Cloud to Smartling, the Salesforce Commerce Cloud Setting page has the following configurations

• Visual Context Settings
• General
• Language Configuration

Visual Context Settings

You can configure visual context for the project. Options include:

• Disable Visual Context: disables automatic default Visual Context. As a result, no Visual Context is provided to linguists in the CAT Tool. However, this options allows for the integration of additional Visual Context tools, such as capturing context by using Smartling's JavaScript Context Capture Library or Smartling’s Context Capture Chrome Extension.
• Default Visual Context: uses a preview URL (if available) or autogenerated pseudo context. Context can be captured if your site is open to the public. If your site uses basic authentication, please select Basic under Authentication Type and enter site credentials under User Name and Password. 

General

You can configure the behavior of the connector when updates are made to your previously translated content.

1. From within your Smartling Salesforce Commerce Cloud Project, click on Project Settings > Salesforce Commerce Cloud Settings.
2. Click the "Automation of Prior Requests for Translation" dropdown to select your desired behavior.
3. Click Save.

Automation of Prior Requests for Translation

This setting controls how you want Smartling to monitor changes to content that has already been translated in Smartling. Smartling will not detect net new content, only updates to content that have been submitted for translation in the past.

Options include:

• Auto: The Salesforce Commerce Cloud Connector will detect changes to source content every 3 hours.
  • Any changes detected to the source content will be submitted to Smartling for translation, batched into a Job and sit in awaiting authorization. However, if auto-authorize is enabled under Smartling Settings, the updated content will be batched into a Job and automatically authorized for translation.
• Manual: The Salesforce Commerce Cloud Connector will detect changes to source content every 3 hours, but will not automatically submit content changes for translation.
  • Changed content can be filtered for in the Salesforce Commerce Cloud Asset list by selecting the Out of Sync checkbox. A user can then manually select the assets that should be re-translated, and Request Translation from the Actions dropdown.
• Disabled: The Salesforce Commerce Cloud Connector will not detect changes to source content or automatically submit new changes.

3 hours is the recommended shortest time duration between checks. Talk to your Solutions Architect about changing the frequency to longer wave periods using cron.

 

Language Configuration 

In the Language Configuration section, you will see the number of target languages in your Smartling project. The first time you open this page, you will find a blank field to the left of each of the Smartling target languages. You must select the correct target language from Salesforce and match it to the target language of the Smartling project to complete language mapping. 

Any language left blank will not appear in the dropdown list of target languages when you Request Translation of content.

Each time you add a new language to the project, you must map that language in the connector settings.

1. From within your Smartling Salesforce Commerce Cloud Project, click Settings > Salesforce Commerce Cloud Settings.
2. Under Source Language (Salesforce Commerce Cloud), choose the language of your content in Salesforce
   1. This must match the source language of the Smartling project, found under Source Language (Smartling)
3. Next, map each target language in Salesforce with the target language in Smartling, by choosing the Salesforce target language from the dropdown menu
4. Click the checkmark to save each mapping
   

Integrate Shared Libraries

Content pages from both private and shared libraries can be translated by SFCC Connector. Private libraries are integrated automatically.

To integrate a shared library, input the shared library ID and name under Shared Libraries in the SFCC project settings.

Multiple shared libraries can be integrated by clicking Add new library.

To remove a shared library from the integration, click the bin icon.

Smartling Settings

Talk to your Customer Success Manager or Solutions Architect about options on auto-authorization.