AEM Touch Connector

AEM Touch Connector Request Translations

This article is for Account Owners and Project Managers.

The Smartling Adobe Experience Manager (AEM) Touch connector allows you to translate AEM content with context. Translations are requested from within AEM, and translated content is automatically sent back to your environment.

The connector supports translation of pages, i18n dictionaries, and tags via AEM Translation Projects.

Request Translations

Once you have installed and configured the AEM Touch connector, you can begin submitting content to Smartling for translation.

In the AEM Touch Page Editor, the Smartling: Translate as Job menu item will allow you to submit the current page and child pages for translation.

Translate Pages

  1. From the Sites view, open the page for translation in the AEM Touch Page Editor by selecting it and clicking Edit.
  2. Select Smartling: Translate as Job from the Page Information menu to bring up the Smartling - Translate window.
  3. Type in a Job Name for this submission and select a Due Date for translation, if applicable, or select an existing job to add this submission from the Add to Job tab.

    • Check Authorize Job if you'd like to authorize the content for translation automatically.
    • Check Include all Sub-pages to include all of the current pages' sub-pages in the submission.
    • Check Force resubmission (Required if page is unchanged).
    • Select the languages to translate in this submission.

Translate Content in Bulk

The Include all Sub-pages option in the Smartling - Translate window allows bulk submission of a page and all of its sub-pages.

Not seeing all of your page content available for translation in Smartling? Check that all of the relevant Properties are included for translation in Tools > General > Translation Configuration for the context path being submitted in AEM.

Resubmit Options

The Force resubmission (Required if page is unchanged) option in the Smartling - Translate window allows you to submit an original page to Smartling even if there are no changes after the last submission. By default, AEM doesn't submit such pages, but if for some reason you need to resubmit an original page, you can enable this option and the Smartling connector will make AEM think that the original page was modified, and should be submitted for translation.

Include Visual Context with your Translation Request

A Visual Context capture tool is built into the AEM Touch connector, helping linguists get your translations right the first time - reducing translation cost and time to market.

If Visual Context is not displaying properly in Smartling, your AEM Administrator should check the Smartling settings in AEM's Web Console Configuration page, or enable a Proxy Connection in Smartling - Network Settings

Check the Status of Translations

The Smartling Connector creates a smartling-auto Project folder in AEM, with subfolders for each date content is submitted. To check the status of a Job, go to the corresponding folder within the smartling-auto Project and open the Translation Project. Click the ... icon on the Job to view the contents and State of each page in the Job.  For more detailed translation progress information, check the Job status in the Smartling Dashboard.

Check Translation Status More Frequently

By default, the AEM Touch connector checks checks translation progress once per day, but you can set it to do so more often. 

To set the AEM Touch connector to check translation progress every four hours:

  1. Open the AEM Web Console (/system/console/configMgr)
  2. Scroll down to Translation Platform Configuration
  3. Next to Scheduler Cron, enter the new cron expression: "0 0 0/4 1/1 * ? *"

  4. Save your changes. 

Download Translations

AEM will download translations automatically after all of the content in the Translation Project is published. There may be a delay after content has been translated as the download process runs in accordance with the Scheduler Cron. The AEM Touch interface does not allow for manual download of translations from Smartling.

Handle Updates to AEM Content

The AEM Connector does not automatically resubmit pages with updates. To resubmit a page with updates, use Smartling: Translate as Job once again to submit the page and create a new job. Only new strings that were not previously submitted will be created and added to the new job.

Request Translations by References Panel

Smartling does not recommend using the default AEM submission flow via the References panel, nor manually creating translation projects.

When you submit pages via the References panel, the Smartling connector will do the following:

  • Create a Smartling job with a name that consists of the current date, page path, and unique identifier.
  • Attach uploaded file to the job above.
  • Job will not be authorized automatically. You can can decide when to authorize the job as needed.

Additional notes:

  • A Smartling job is created for every AEM project. For example, you might submit a page for three languages. AEM will then create three translation projects (one per language), and in turn, the Smartling connector will create three jobs.
  • All pages that are added to the same AEM project will be attached to the same Smartling job. For example, if you submitted "pageA" for "French", it will be added to the Smartling job "2018-01-01 - pageA - 1". Later on, if you submitted "pageB" also for "French", and used the existing AEM translation project, then "pageB" will be attached to the Smartling job "2018-01-01 - pageA - 1"
  • Smartling jobs are not authorized automatically.

Was this article helpful?