Install - inRiver PMC

Prerequisites

There is a number of things that must be in place before you can start the configuration of the translation connector. The installation and set-up should always be carried out by a competent Solution Integrator or suitably qualified person.

• An agreement and a Freeway account must be set up, and you need the log in credentials

• You must have a list of possible source- and target languages verified

• The translation process and decided upon the services

• Get a list of mappings between the PIM languages and the Translation languages.

Technical

• An inRiver PMC environment

Step 1. Uploading the deployment package

Navigate to

• inRiver Control Center

• Select customer and environment

• Navigate

  • Connect → Packages

• Drag and drop the deployment package to the 'Select file to upload' box and press 'Upload'

Step 2. Setting up the language configuration file

The language configuration file needs to be set up

Note: The language configuration file format has changed - Language Configuration

Step 3. Adding the extensions

Navigate to

• inRiver Control Center

• Select customer and environment

• Navigate

  • Connect → Extensions

• Adding the following extensions by clicking "Add Extension"

• Note: If there is no intention to use the automatic Translation Job sender, then AutomatedTranslationSenderExtension does not need to be installed.

Extension Id	LionbridgeAutomatedTranslationSender
Package	LionbridgeTranslator.zip
Assembly Name	Lionbridge.inRiver.Extension.Translation.dll
Assembly Type	Lionbridge.inRiver.Extension.Translation.Extension.AutomatedTranslationSenderExtension
Extension Type	ScheduledExtension

Extension Id	LionbridgeBaseTranslationFunctionality
Package	LionbridgeTranslator.zip
Assembly Name	Lionbridge.inRiver.Extension.Translation.dll
Assembly Type	Lionbridge.inRiver.Extension.Translation.Extension.LionbridgeTranslationEntityUpdateExtension
Extension Type	EntityListener

Extension Id	LionbridgeFreewayUpdater
Package	LionbridgeTranslator.zip
Assembly Name	Lionbridge.inRiver.Extension.Translation.dll
Assembly Type	Lionbridge.inRiver.Extension.Translation.Extension.TranslationEntityPeriodicUpdateExtension
Extension Type	ScheduledExtension

Step 4. Configure the extensions

If you've just now completed the previous step, you can skip the Navigation step below, and continue to Configure.

Navigation

Navigate to

• inRiver Control Center

• Select customer and environment

• Navigate

  • Connect → Extensions

Configure

Click the Extension you want to configure

When running the configuration process for the first time after the Extension has been installed, you will need to click the "Get Default Settings" button on the top-right of the "Settings" section.

Here are some examples of settings for each extension

LionbridgeAutomatedTranslationSender

(example LionbridgeAutomatedTranslationSender Extension)

Setting	Value	Note
LionbridgeAuthServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address - The authentication service address provided by Lionbridge
LionbridgeActionServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address - The action service address provided by Lionbridge
LionbridgeUsername	username will be supplied by Lionbridge Connector team at deployment.	Freeway account username - The Freeway account username provided by Lionbridge
LionbridgePassword	password will be supplied by Lionbridge Connector team at deployment.	Freeway account password - The Freeway account username provided by Lionbridge
SendOnlyTranslatableData	False	Boolean (True/False) - Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)
TranslateLocaleCvl	False	Boolean (True/False) - Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.
TranslationConfiguration	<XML>	XML - Translation Configuration, more information on how to configure this can be found here.
CriteriaConfiguration	<XML>	XML - Criteria Configuration (Optional), more information on how to configure this can be found here.
TranslationFileEntityLimit	1000	Integer - Max number of entities that can be added to each translation file sent to Lionbridge Freway before the file is split into multiple files
Username	pimuser1	Username - User that created the query that finds entities that should be translated
Query	Products	Query name - The name of the query that finds entities that should be translated
IgnoreDateModifiedForLocaleStrings	False	Boolean (True/False) - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)
IncludeMainPictureUrl	False	Boolean (True/False) - Optional - enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)
TranslationDateComparisonMode	Newer	Optional - Toggles which date comparison method should be used to determine if a field needs translation. Possible values NewerOrEqual Source language value's last modified date is the same or more recent than the target language. Newer - (default) Source language value's last modified date is more recent than the target language.

LionbridgeBaseTranslationFunctionality

(example LionbridgeBaseTranslationFunctionality Extension)

Setting	Value	Note
LionbridgeAuthServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address. The authentication service address provided by Lionbridge
LionbridgeActionServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address. The action service address provided by Lionbridge
LionbridgeUsername	username will be supplied by Lionbridge Connector team at deployment.	Freeway account username. The Freeway account username provided by Lionbridge
LionbridgePassword	password will be supplied by Lionbridge Connector team at deployment.	Freeway account password. The Freeway account username provided by Lionbridge
SendOnlyTranslatableData	False	Boolean (True/False). Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)
TranslateLocaleCvl	False	Boolean (True/False). Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.
TranslationConfiguration	<XML>	XML - Translation Configuration, more information on how to configure this can be found here.
CriteriaConfiguration	<XML>	XML - Criteria Configuration (Optional), more information on how to configure this can be found here.
IgnoreDateModifiedForLocaleStrings	False	Boolean (True/False) - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)
IncludeMainPictureUrl	False	Boolean (True/False) - Optional - enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)
TranslationDateComparisonMode	Newer	Optional - Toggles which date comparison method should be used to determine if a field needs translation. Possible values NewerOrEqual Source language value's last modified date is the same or more recent than the target language. Newer - (default) Source language value's last modified date is more recent than the target language.

LionbridgeFreewayUpdater

(example LionbridgeFreewayUpdater exension)

Setting	Value	Note
LionbridgeAuthServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address. The authentication service address provided by Lionbridge
LionbridgeActionServiceAddress	urls will be supplied by Lionbridge Connector team at deployment.	Freeway Service Address. The action service address provided by Lionbridge
LionbridgeUsername	username will be supplied by Lionbridge Connector team at deployment.	Freeway account username. The Freeway account username provided by Lionbridge
LionbridgePassword	password will be supplied by Lionbridge Connector team at deployment.	Freeway account password. The Freeway account username provided by Lionbridge
SendOnlyTranslatableData	False	Boolean (True/False). Whether or not to send more than just the translatable data on an entity (Sends all field data on the entity)
TranslateLocaleCvl	False	Boolean (True/False). Whether or not to send LocaleString CVL values for translation, that are in use by the entities that are being translated.
TranslationConfiguration	<XML>	XML - Translation Configuration, more information on how to configure this can be found here.
CriteriaConfiguration	<XML>	XML - Criteria Configuration (Optional), more information on how to configure this can be found here.
IgnoreDateModifiedForLocaleStrings	False	Boolean (True/False) - disable/enable a check whether the source language have a later modified date then the target language. (Default is False)
IncludeMainPictureUrl	False	Boolean (True/False) - Optional - enable/disable a feature that includes a url to the main picture of a translated object to give translators additional context. (Default is False)
TranslationDateComparisonMode	Newer	Optional - Toggles which date comparison method should be used to determine if a field needs translation. Possible values NewerOrEqual Source language value's last modified date is the same or more recent than the target language. Newer - (default) Source language value's last modified date is more recent than the target language.

Step 5. Configure the inRiver Data Model

Details on how to configure the inRiver data model can be found in the following article. Install - inRiver Data Model

Step 6. Verification

Instructions on how to verify the configuration is correct can be achieved by creating a test translation, more details in the following article. Testing the Lionbridge Translator

Log

The Translation Extensions logs all actions in the logging interface in the inRiver Control Center.

• Check the log if you for example get a Imported with errors, status.