Setting Up Your Salesforce Commerce Cloud Connector

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

• General
• Language Configuration

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.

Due to the Google Suite's auto-save functionality, it is recommended that this be disabled in your project, so that any files that are ready for translation in your selected root folders are final and unedited. Any changes to source content should be made on a copy of the original file.

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 insert a name for each target language in each field and save 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 on Project Settings > Salesforce Commerce Cloud Settings.
2. Insert the name of the language as you want it displayed in your translated file name or subfolder (depending on your translation folder configuration).
   
   • This field is completely customizable 
   • If your delivery settings are configured with the target language in the file name, it is recommended that the target language name uses minimal character count, as this will be appended to your file name with an underscore, e.g.:
     
   • If your delivery settings are configured with the target language in the subfolder, it is recommended that the target language name uses a folder title you will easily identify, as this will be the title of the subfolder within the specified target folder, e.g.:
     
3. Click the checkmark to save each mapping
   

Smartling Settings

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