This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Welcome to the Cartridge

Welcome to the Lionbridge Cartridge for Salesforce Commerce Cloud (Cartridge) version 1.1.0. This is Clay Tablet’s connector between Salesforce Commerce Cloud and the Clay Tablet Platform. It enables you to manage the translation of products, catalogs, categories, and static Web content in your Salesforce Commerce Cloud sites.

1 - Terminology

Amazon AWS Amazon Web Services. A suite of web application products developed and sold by Clay Tablet uses various AWS offerings in order to leverage their infrastructure and build rich, dynamic solutions for its customers, specifically, the Clay Tablet Platform. For details, see
Amazon S3 Amazon Simple Storage Service. For details, see: The Cartridge and the Clay Tablet Platform use Amazon S3 to provide temporary storage services for the content sent to and from translation.
Amazon SQS Amazon Simple Queue Service. For details, see: The Cartridge uses Amazon SQS to provide Message Queue Services.
Asset Any content or document being sent for translation, including metadata. Assets are created by the Cartridge.
Clay Tablet (CTT) Clay Tablet Technologies, the corporate entity that publishes the Lionbridge Cartridge and the Clay Tablet Platform.
Clay Tablet Platform The hosted (IaaS) connectivity platform that receives and routes content from content systems, including content management systems (CMSs), to translation providers and back during implementation. The Lionbridge Connector Team configures the Platform based on the number and nature of systems involved in your system architecture.
Freeway The name of the Lionbridge translation portal for submitting content to and retrieving content from the Lionbridge translation provider.
FTP Server File Transfer Protocol (FTP) is a standard network protocol used to transfer files from one host to another host over a TCP-based network, such as the Internet. Translation providers may receive and send files for translation using an FTP server.
IaaS Infrastructure as a Service. The Clay Tablet Platform is an IaaS, because it is a hosted platform.
Keys The Cartridge uses keys to establish a secure, discrete connection between the Cartridge instance and the Platform.

Very important: Do not copy the CMS address keys to multiple instances, because this is a violation of the Clay Tablet License Agreement. Using the same CMS address keys on multiple instances will cause the Cartridge to behave unexpectedly, which can result in lost translation content, orphaned projects, and inaccurate translation status reports. Clay Tablet will support technical issues caused by duplicating or incorrectly installing CMS address keys only on a time and materials basis.
Lionbridge The publisher of the Freeway translation portal and a translation provider. Users connect to the Freeway translation portal to submit content to and retrieve content from the Lionbridge translation provider.
Lionbridge Cartridge for Salesforce Commerce Cloud (Cartridge) The cartridge software that Clay Tablet Technologies has developed and provides, which plugs into your Salesforce Commerce Cloud installation to provide connectivity to our hosted Platform. In this document it is referred to as the Cartridge. This is the software you are installing and configuring as you work through this document.
MT Machine translation. The translation provider can be a machine translation service, such as Google Translate.
Producer CMS or another system that sends content or documents out for translation. In this case, this is your Salesforce Commerce Cloud.
Provider A provider of translation services. The delivery of assets to the provider may be via an FTP server or a TMS connector.
Support Asset Supporting documents and their metadata.  Support assets are not translated by the translation provider, but they provide helpful context for the translator.
TMS Translation management system that the translation provider uses.

2 - About the Clay Tablet Translation Platform

The Clay Tablet translation-connectivity platform is the easiest, most flexible way to integrate content systems, including content management systems (CMSs) and other content producers, with translation providers and translation technologies.

Clay Tablet Platform is the hosted (IaaS) connectivity platform that receives and routes content from content management systems to translation providers and back, including to Lionbridge via Freeway. It is hosted on Amazon Web Services (AWS). During implementation, the Lionbridge Connector Team configures the Platform for your translation solution, based on the translation providers or systems you use. The Clay Tablet Platform uses the following services on AWS: 

  • S3 (Amazon Simple Storage Service), which provides storage services for the content sent to and from translation.

  • SQS (Amazon Simple Queue Service), which provides message queue services.

3 - How the Cartridge Works with Salesforce Commerce Cloud

The Lionbridge Cartridge (Cartridge) is an important part of the Clay Tablet translation solution.

The Cartridge is installed on your system as an add-in to Salesforce Commerce Cloud. Its functionality is displayed to the users as part of Salesforce Commerce Cloud.

Your translation systems architecture might look like the configuration above. It may have additional content systems or translation providers, but the core concepts remain the same.

During implementation, Lionbridge Connector Support works with you and your translation providers to configure and test the other elements of your translation solution, which are the Clay Tablet Platform’s connections to your translation providers' systems.

4 - Using this Guide

Purpose of this guide

This guide describes everything you need to know to install and configure the Lionbridge Cartridge (Cartridge) for Salesforce Commerce Cloud. It describes the delivery package contents, system requirements, installation instructions, and configuration procedures.

Recommendation: Review the user guide to fully understand the powerful features of the Cartridge.

Who should use this guide

This guide is intended for Salesforce Commerce Cloud administrators and system integrators.

What you should already know

This document assumes that your company already has an installed instance of Salesforce Commerce Cloud. It assumes that you have a strong working knowledge of Salesforce Commerce Cloud and its features.

How to find out more about the Lionbridge Cartridge for Salesforce Commerce Cloud

For information on using the Lionbridge Cartridge to send and receive content for translation from Salesforce Commerce Cloud, read the Lionbridge Cartridge for Salesforce Commerce Cloud User Guide.

Documentation conventions

This guide uses the following conventions:

Convention Description
Bold Highlights screen elements such as buttons, menu items, and fields.
Courier Highlights input, file names, and paths.
Italics Highlights terms for emphasis, variables, or document titles.
> Indicates a menu choice. For example, “Select Admin Tools > Configuration.”

5 - How to Contact Lionbridge Connector Support

How to Contact Lionbridge Connector Support

You can submit a support ticket either:

See also: