Connect Acrolinx Reuse to SDL TMS/WorldServer

Acrolinx Reuse is one solution for storing and reusing commonly used sentences, but translation memory solutions also help you store and reuse sentences. If you use SDL WorldServer or SDL Translation Management, you can configure Acrolinx to deliver your reuse results from this solution.

For example, suppose that you want to use Acrolinx to check your content, but you want to get your reuse results from your translation memory. You can configure Acrolinx so that your translation memory supplies the content for the reuse component when writers check their content with Acrolinx.

To integrate Acrolinx with your SDL TMS/WorldServer, you must configure the language servers to use the translation memory instead of Acrolinx Reuse. 

To connect Acrolinx Reuse to SDL TMS/WorldServer, follow these steps:


  1. Open your overlay of the relevant language configuration file.

    If you haven’t yet created an overlay of this file, create a new version of the file at the following location:

    %ACROLINX_CONFIGURATION_ROOT%\data\<LANG_ID>\configuration.properties

    If this location doesn’t yet exist, create the required subdirectories first.

  2. Add the following properties:

    Table 1. External Reuse Properties

    PropertyUse toValue
    reuse.useEnrichContentReuse Set your translation memory as reuse component and disable the Acrolinx Reuse component. reuse.useEnrichContentReuse=<TRUE/FALSE> Example:
                      reuse.useEnrichContentReuse=true
                    
    reuse.enrichUrl Configure the URL of the REST API of SDL Enrich. The URL must be an HTTPS URL. reuse.enrichUrl=<URL> Example:
                      reuse.enrichUrl=https://10.10.30.194/Api/Authoring
                    
    reuse.stsUrl Configure the URL of the SDL Security Token Service. reuse.stsUrl=<URL> Example:
                      reuse.stsUrl=http://10.10.30.194/sts/api/RequestSecurityTokenResponse
                    
    reuse.enrichSessionUrl Configure the URL of the LiveContent Enrich API. The URL must be an HTTPS URL. reuse.enrichSessionUrl=<URL> Example:
                      reuse.enrichSessionUrl=https://10.10.30.194/
                    
    reuse.enrichLanguage Specify the language to retrieve from your translation memory. This property is only necessary if the supported languages of your translation memory don’t match the language of the Acrolinx language server. The default value is the language of the Acrolinx language server. reuse.enrichLanguage=<LANGUAGE_CODE> Example:
                      reuse.enrichLanguage=en-GB
                    
    reuse.timeout Configure the maximum number of milliseconds Acrolinx waits for responses from the server where your translation memory is hosted. Acrolinx starts waiting after the document check is complete. Any outstanding requests after the timeout are ignored. The default value is 60000. reuse.timeout=<NUMBER_IN_MILLISECONDS> Example:
                      reuse.timeout=60000
                    
    reuse.stsUserName Configure the username for the Security Token Service (STS) authentication. This should be a name that isn’t already present in the user database that your translation memory software uses (for example, the client's Active Directory database or equivalent).

    If more than one Acrolinx server contacts a single translation memory server, the username allows you to distinguish the calls from each system. If this property isn’t configured, the default value is "AcrolinxServer".

    reuse.stsUserName=<USER_NAME> Example:
                      reuse.stsUserName=AcrolinxServer
                    
    reuse.enrichProfileUsage Configure if an Enrich profile should be used for the reuse request. reuse.enrichProfileUsage=<PROFILE_TYPE>

    You can set the value none, fixed, or mapped

    • Select none if you're not going to use a profile ID.
    • Select fixed to use the enrichProfileId.
    • Select mapped to map check request's rule set to a profile ID via the property enrichMappedProfileId . If no mapping for the rule set is found, the enrichProfileId is used as a fallback.


    . Example:
                      reuse.enrichProfileUsage=none
                    
    reuse.enrichProfileId Configure the profile ID, which is used when reuse.enrichProfileUsage is set to fixed. The system also uses the profile ID when reuse.enrichProfileUsage is set to mapped but the check's rule set has no mapping in the property enrichMappedProfileId. reuse.enrichProfileId=<PROFILE_ID> Example:
                      reuse.enrichProfileId=11de-4145-8aa4
                    
    reuse.enrichMappedProfileId Configure the mappings from rule set names to profile IDs. reuse.enrichMappedProfileId.<RULE_SET_NAME>=<PROFILE_ID> Example:
                      reuse.enrichMappedProfileId.Marketing=11de-4145-8aa4
                    

    With this property, the reuse request issued by the Acrolinx server adds the profile id "11de-4145-8aa4" when using the rule set "Marketing".

  3. Save your changes and reload the language configuration on the relevant language servers.

    When writers check for reuse issues, Acrolinx now uses your translation memory as a content source.

    Remember that once you enable your translation memory as a reuse component, you can still see the reuse configuration page in the Dashboard. However, any actions you perform on this page don’t have any effect.