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.
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.
Last modified 27d ago