Configuring Translation Settings in the Configuration File

You configure the Connector’s translation settings by modifying the following configuration file: Website_root/Website/App_Config/Include/CT3Translation.config. You can specify the following settings:

Setting Name Description Supported Values Default Value
ClayTablet.
Project
Identifier
This creates the prefix for identifying the client in translation projects. For example, if the “ABC” client sets this to ABC and sends out the marketing_post_Aug08 item for translation, the name of the translation project is ABC_marketing_post_Aug08.

Note: Relevant only when Lionbridge Freeway is the translation provider.
a text string ClientName
ClayTablet.
PackedFile
Format
The Connector can export Sitecore content (field content) in two different formats: XML and HTML.  XML is the default format, which is acceptable to most translation providers.  If your translation provider has difficulties handling XML files and can handle only HTML files, then you can change this setting to HTML. either XML or HTML XML
ClayTablet.
Translate
Common
FolderItem
Determines whether or not the Connector sends out for translation content items that are based on a common-folder template, located in: Templates/Common/Folder. This determines whether the Connector sends out the folder’s fields, including the folder name, for translation. * True
* False
False
ClayTablet.
Preview
URL
Determines whether or not to include a preview URL in the XML file, which enables translators and reviewers to preview the content. You can include the following parameters in the preview:

* {id}: Sitecore item ID of the translated item.
* {version}: The source version of the translated item.
* {lang}: The source language of the translated item.
* {targetversion}: The target version created as result of the translation.
* {targetlang}: The target language for the translation.
* {jobid}: The Connector translation job ID.

**Note:** You must replace & with &. Otherwise the configuration file will not be valid XML, for example: <setting name=“ClayTablet.PreviewURL” value=“http://www.yourcompany.com/ preview?id={id}&language={lang}&version={version}&jobid={jobid}” />

**Note:** To configure this setting, uncomment this section.
ClayTablet.
SendJob
Metadata
Determines the format for sending job metadata.

* To send job metadata in a format compatible with the Connector for Sitecore version 3.6 or higher, set this value to True.
* To send job metadata in a format compatible with the Connector for Sitecore version 3.5 or lower, set this value to False.
* True
* False
* True for new Connector installations
* False for upgraded Connector installations
ClayTablet.
Remove
Control
Characters
Some translation providers and translation management systems may not be able to handle control characters, such as 0X10 and 0X13. They may treat an XML file with these characters as invalid. This option instructs the Connector to automatically remove all control (non-printing) characters (0x00-0x1F) from an XML file before sending it out for translation.

* To automatically remove all control (non-printing) characters from an XML file before sending it out for translation, change this setting to True.
* To keep all control characters in an XML file sent out for translation, keep this default setting of False.
* True
* False
False
ClayTablet.
Translate
Display
Name
Supports sending out an item’s display name for translation. * true
* false
false
ClayTablet.
Sitecore.
Preserve
Temporary
Files
Supports saving the temporary, generated files in the following scenarios:

* The Connector sends out files for translation (source folder).
* The Connector sends out files for TM update.
* The Connector receives translated files from the Platform (target folder).

Usually the Connector deletes these temporary files when it finishes processing them. However, they are useful for debugging and general troubleshooting.
* true
* false
false
ClayTablet.
CheckItems
InTranslation
Determines whether the Connector checks that items in a new translation job were not previously sent out in another job that is currently in progress. The default value of this new setting is true, which maintains the previous behavior. * true
* false
true