Skip to main content
Skip table of contents

Acrolinx


The Acrolinx content guidelines software integrates with the Content Editor of censhare Web. The Acrolinx integration for censhare makes the rules that you define in Acrolinx available in the content editor of censhare Web. Authors can see in real-time if their content conforms with the content guidelines.

Context

The Acrolinx configuration is configured in the censhare Admin Client. The Acrolinx widget is available in the Content editor of censhare Web. To set up the integration, the Acrolinx module must be enabled. To configure the integration, you need an Acrolinx account to connect to. The content language guidelines that you want to use in censhare must be defined in Acrolinx.

Prerequisites

Users need an Acrolinx account with the respective credentials for SSO via the censhare platform.

Introduction

censhare Web provides integrated content and translation management. Users can thus carry out asset management and content management on the same platform. With the native Content editor application, censhare provides a WYSIWYG editor to edit content directly on an asset page. The Content editor integrates with translation tools and applications like Translation with Memory, the XLIFF exporter, or the Lionbridge connector.

Acrolinx is a platform that uses artificial intelligence for real-time content analyses. Acrolinx users can define language-specific and audience-specific rules for their content. Thes rules comprise grammar and spelling checks, terminology, style, and tone of the content.

The Acrolinx integration for censhare makes the rules that you define in Acrolinx available in the content editor of censhare Web. The content is analyzed and the score is shown in the widget. Authors can see in real-time if their content conforms with the content guidelines.

The Acrolinx integration uses Single Sign-On (SSO) to authenticate a user that is logged into censhare Web. If a censhare Web user opens the Main content asset and goes to the Content tab, the Acrolinx interface starts automatically and retrieves the profile from the Acrolinx server.

Acrolinx configuration

The configuration is done in the censhare Admin Client. In the Configuration/Modules folder, open the Acrolinx settings configuration dialog.

Enable the Acrolinx module

In the General setup area of the Acrolinx settings dialog:

  1. In the Server name field, select the server on which the module runs. 

  2. Activate the Enabled field.

  3. Optionally, add the desired Roles that can access Acrolinx.

Server URL and authentication key

Note: To use the SSO authentication with censhare Web, you must configure the core server properties of your Acrolinx application. For more information, see the Acrolinx documentation.

  1. In the Acrolinx server field of the Acrolinx settings dialog, enter the URL through which censhare accesses Acrolinx. For example, https://your-company.acrolinx.com/.

  2. In the SSO secret key field, enter the secret key of the SSO certificate.

  3. Click OK to save the configuration.

  4. Update the server configuration.

Language mapping

Note: Before you can add the language mapping, complete the previous configuration and update the server configuration. Otherwise, censhare cannot load the available languages from the Acrolinx server.

To add a language mapping:

  1. In the header bar of the censhare Admin Client, click

     and select Acrolinx settings. This action initializes the Acrolinx integration and imports the available languages from the Acrolinx server.

  2. Open the Acrolinx settings configuration you created.

  3. In the Language mapping area, select a censhare content language and a corresponding Acrolinx language for rules and guidelines.

  4. To add more mappings, click + and repeat the previous step.

  5. Click OK to save the nconfiguration.

  6. Update the server configuration again.

  7. If necessary, synchronize the remote servers.

Truststore configuration

To enable secure access of Acrolinx to censhare, you must add an SSL certificate to the truststore of the censhare Server. To get an SSL certificate, please contact the Acrolinx support.

  1. Store the Acrolinx SSL certificate on the censhare Server.

    Look up the truststore path in the censhare Admin Client, in the Configuration/Server/General configuration. The certificate must be added there. The default path is @current.runtime.dir@config/truststore.

  2. To add the certificate to the truststore, execute the following command in a terminal window:

    CODE
    keytool -import 
             -alias <ALIAS_NAME> 
             -file ~/<PATH>/ssl.acrolinx.com.cer 
             -keystore censhare-Server/work/runtime.master/config/truststore
  3. Restart the censhare Server.

Note: On production systems, we recommend to use SSL certification for third-party access to the censhare server. If you do not need SSL certification on your system, you can disable the truststore in the censhare Admin Client. Open the Configuration/Server/General configuration, disable the javax.net.ssl.trustStore property, and restart the censhare server.

Testing & troubleshooting

To test your configuration, log in to censhare Web and open the Main content asset of a Text asset. Go to the Content tab. The Acrolinx widget initializes in the right column of the main area.

The following configuration errors can occur:

Error message

Cause / Solution

No Acrolinx language mapped to Asset content language

For the content language of the current asset, no Acrolinx language profile mapping exists, or no content language property exists in the current asset. Do the following:

  1. Open the Edit properties dialog of the current asset.

  2. If the Content language field is empty, add the respective language.

  3. If a Content language property exists, go to the censhare Admin Client, open the Acrolinx settings and add a language mapping for the respective language.

  4. Ensure that all content languages are mapped to an Acrolinx language profile.

  5. Ensure that the Content language property is correctly set in your content templates.

Invalid language mapping

The current content language is mapped to two or more Acrolinx languages. Do the following:

  1. In the censhare Admin Client, open the Acrolinx settings and change the language mapping.

  2. Ensure that each censhare language is only mapped to one Acrolinx language profile.

Ambiguous content language mapping

The current asset has two or more content language properties that are mapped to different Acrolinx language profiles. For example, the main language EN and the secondary language EN_marketing are set in the Text asset. The language EN is mapped to the Acrolinx language profile en-Standard UK. The language EN_marketing is mapped to the Acrolinx language profile en-Marketing UK. Do one of the following:

(1) Only one content language per asset:

  1. Remove secondary language properties from the content asset.

  2. Ensure that your content templates only contain one language asset property.

  3. If possible, disable the Multiple values field in the language feature definition.

(2) No language mapping for main or secondary content languages:

  1. In the censhare Admin Client, open the Acrolinx settings and remove the mappings for the main or the secondary language.

  2. If more than two content language properties are allowed in your content assets, make sure that only one language is mapped to an Acrolinx language profile.

(3) Unambiguous mappings for secondary languages:

  1. In the censhare Admin Client, open the Acrolinx settings.

  2. Ensure that the main content languages and the respective secondary content languages are mapped to the same Acrolinx language profile.

The following errors can occur during the initialization:

Error message

Cause / Solution

It looks like this isn’t an Acrolinx Server or this server version doesn’t support the Sidebar. Ask your Acrolinx administrator to check your server version if you’re sure that the Acrolinx URL is correct.

The widget cannot connect to the Acrolinx server, because there is no valid SSL certificate. For more information, see the Truststore configuration section.

Misconfigured SSO

The logged-in censhare user cannot be authenticated from Acrolinx via SSO.

  1. Log out with the current user.

  2. Log in with a user that has the necessary Acrolinx permissions.

Result

You have learned how to integrate Acrolinx into the Content editor of censhare Web.

Related content

Acrolinx documentation

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.