You are here: Installation and Configuration Guides > Connector for Sitecore > Configuring the Connector for Sitecore > Upgrading Account Keys for Current Translation Providers

Upgrading Account Keys for Current Translation Providers

If you are upgrading your Connector installation from version 3.x to 4.x, you must upgrade the account keys for your current translation providers. To obtain your new account keys, contact Lionbridge Connector Support. For details, see How to Contact Lionbridge Connector Support.

Very important: Do not use the same account keys on multiple instances, because this is a violation of the License Agreement. Using the same account keys on multiple instances will cause the Connector to behave unexpectedly, which can result in lost translation content, orphaned projects, and inaccurate translation status reports. The Lionbridge Connector team will support technical issues caused by duplicating or incorrectly installing CMS address keys only on a time and materials basis.

Note: During the upgrade process, the Connector does not remove the XML and configuration files from the previous configuration. You can back up these files and remove them later, after the upgrade process is complete.

To update your account key for your translation providers:
  1. In the Content Editor, in the content tree, navigate to /sitecore/system/Settings/Lionbridge Settings/Translation Providers Configuration.
  1. In the table, select the translation provider to upgrade, so that it is highlighted.

The fields below prepopulate, if applicable.

  1. Enter or update the following information about the translation provider to upgrade:
Setting Description
Name Enter your name for the translation provider. If you configure multiple translation providers, this is the name that will be displayed when selecting a translation provider while sending out content for translation.
Type Select the type of translation provider. This supports sending translation metadata to specific translation providers. If you do not see your translation provider, select Generic. If you select onDemand or Freeway, additional fields are displayed, as described in the following steps.
Account key

Select the account key for the translation provider. There is one account key for each of your translation providers, as specified by your license ID. Installing your license automatically downloads your account keys.

Note: Only unused keys are available for selection. To view the keys that are already in use, click the Keys already used link below.

Supports quoting

If this translation provider supports providing quotes before the translation process starts, and you want to enable users to request a quote before sending content for translation, select this check box.

Important: The Request Quote feature is available only when sending content for translation to a translation provider (LSP) that supports this feature.

When enabled, this feature displays the Send for Quote check box in:

  • the Bulk Translation wizard
  • the Automatic Item export for translation dialog box
  • the Send Items Out for Translation dialog box, which opens from Translation Queue

Selecting the Send for Quote check box informs the translation provider that you want to receive a quote before the translation process starts.

PO Required You can configure this translation provider so that the PO Reference field is required when submitting content for translation to this provider.
  1. Enter the following information:
Field Description
User The username for logging into the Lionbridge Freeway server.
Password The password for logging into the Lionbridge Freeway server.
API Auth URL Optional. The URI where the Connector receives an authentication token for Lionbridge Freeway. This is https://fwapi.lionbridge.com/obvibundles/freewayauth.asmx.
API Service URL Optional. The URI where the Connector can request a list of Lionbridge Freeway analysis codes. This is https://fwapi.lionbridge.com/obvibundles/service.asmx.
Analysis codes visibility

Optional. Each check box indicates whether to display the corresponding analysis-code field to users when they send out content for translation to Lionbridge Freeway.

  • Require Value 1: If this check box is selected, the first analysis code configured for your company (for example, region) must be displayed to users when sending content to Freeway.
  • Require Value 2: If this check box is selected, the second analysis code configured for your company (for example, department) must be displayed to users when sending content to Freeway.
  • Require Value 3: If this check box is selected, the third analysis code configured for your company (for example, priority) must be displayed to users when sending content to Freeway.

Warning: This configuration is required for full integration between the Connector and Freeway. Otherwise, the Connector cannot retrieve and display analysis code options, and the user cannot specify analysis codes for projects submitted to Freeway. However, even without this configuration, the Connector can still send submitted content to Freeway.

  1. Click Test to test your Freeway settings.

Warning: This configuration is required for full integration between the Connector and Freeway. Otherwise, the Connector cannot retrieve and display analysis code options, and the user cannot specify analysis codes for projects submitted to Freeway. However, even without this configuration, the Connector can still send submitted content to Freeway.

  1. Enter the following information:
Field Description
Access Key ID Your API access key ID, which is your unique identifier. You generate this from the API Information tab in the Account Information page of the Lionbridge onDemand portal.
Access Key Your longer API access key, which is your unique identifier. You generate this from the API Information tab in the Account Information page of the Lionbridge onDemand portal.
API Endpoint The URL of the Lionbridge API, which you receive from liondemand.com, for example: https://my-company.liondemand.com/api.

For more information about obtaining API keys for Lionbridge onDemand, refer to https://support.liondemand.com/hc/en-us/articles/200971004-Obtaining-API-Keys.

  1. Click Test to test your onDemand settings.

Warning: This configuration is required for full integration between the Connector and onDemand. However, even without this configuration, the Connector can still send submitted content to onDemand.

  1. Click Upgrade Provider.

Note: If there are no remaining translation providers to upgrade, the New and Upgrade sub-tabs are no longer displayed, and the page looks like the one described in Configuring Your License ID and New Translation Providers.

  1. Repeat the previous steps for any additional translation providers to upgrade.

Note: The list at the top of the section displays the name, type, quotation-support status and key of all configured providers. To remove a translation provider, select the corresponding row in the table, and then click Remove.