Connect Adobe Experience Manager (On-Premise version) with Smartcat

Discover how to integrate AEM (on-premise) and Smartcat to enhance your content translation workflow, supporting all localization-enabled fields.

Discover how to integrate AEM and Smartcat to enhance your content translation workflow, supporting all localization-enabled fields.

If you want to learn more about the Adobe Experience Manager cloud installation guide, visit this link.

Installation

Notice: AEM Administrator permissions are required for connector installation.

Important: Tested with AEM version 6.5. For assistance with installation on earlier versions, please contact our support team.

Smartcat connector installation

Download the ZIP file of the Smartcat Connector using this link.

Navigate to the Tools → Deployment → Packages.

Click Upload Package, select and upload.zip file with Smartcat connector.

Install the uploaded package.

Refresh page and check that installation is complete.

Set up Smartcat connector configuration

Set up global configuration

Notice:This configuration will be selected by default for all translations

Navigate to the Tools → Cloud Services → Translation Cloud Services.

Go to conf → global and click Create.

Select Smartcat Connector in the dropdown list and type a meaningful name for it.

Click Create and fill Account ID and API Key in configuration settings.

  • Here, you need Smartcat workspace administrator permission;

  • You can get it from Smartcat workspace, go to Settings → API section;

  • Create a new key if needed;

Click Validate to check connection. You should see a confirmation message.

(Optional) After validation you can select a project template that will be used in all Smartcat projects created via this connection.

By default, a project will be created with the workflow, AI translation - Post editing

Save & Close settings, then go to conf → global and click Create.

Select Translation Integration and complete the form:

Note : USE THESE VALUES ONLY

  • Title: Default Configuration

  • Name: default_translation

Set up Smartcat as the default translation provider.

  1. Select Smartcat connector as the translation provider in all tabs, for both Machine Translation and Human Translation methods where applicable.

  2. Select Human Translation to use Smartcat project-flow with template from the connection configuration.

  3. Check translation settings if needed to:

    A. Include metadata/tags for Sites and Assets.

    B. Automatically start translation job when it's created.

Save and close configuration settings.

This global config. will be used e.g. by default when creating a language copy of site pages:

If something went wrong

Notice: AEM may not allow you to delete default configuration even with admin permissions.

Use this manual to delete global config:

Using CRXDE Lite

  1. Login to AEM CRXDE Lite:

Open your web browser and navigate to http://<your-aem-instance>:<port>/crx/de. Log in using your admin credentials.

2. Navigate to the Configuration Node:

In the CRXDE Lite interface, navigate to the path where the global cloud translation configurations are stored. This is usually under /conf/global/settings/cloudconfigs/translation.

3. Locate the Configuration:

Find the node that corresponds to the global cloud translation configuration you want to delete.

4. Delete the Node:

Right-click on the node and select Delete. Confirm the deletion when prompted.

5. Save the Changes:

Click on Save All to apply the changes.

Set up several configurations

If you want to use various project templates you can create and use several configurations.

AEM allows you to have only a single configuration per template.

Creating configurations

  1. Navigate to the Tools → General → Configuration Browser.

  2. Create a configuration path for extra configurations.

3. Add a subpath for exact Smartcat connection:

4. Navigate to the Tools → Cloud Services → Translation Cloud Services.

5. Go to the high-level path and create any configuration to see subpaths. You may exit without saving it.

6. Select path to exact Smartcat connection and create a connector withthe desired configuration:

Using configurations

  1. When setting up translation configuration, click Select Configuration Path.

2. Select path to the Smartcat connector configuration that you need.

3. You should see correct config. in settings:

4. Proceed with translation flow further as usual.

Want to know more about the translation process? Check out our step-by-step guide on translating your content in Adobe Experience Manager with Smartcat.