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 the translation of pages, Content Fragments, Experience Fragments, i18n dictionaries (such as that contained in Forms), 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 allows you to submit the current page and child pages for translation.
translate_as_job.png

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 dialog.
  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.
    Screen_Shot_2018-06-08_at_15.26.04.png

    • Check Authorize Job if you'd like to authorize the content for translation automatically.
      Screen_Shot_2018-06-08_at_15.51.17.png
    • 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.

If your page contains Content Fragments and/or Experience Fragments, they will automatically be included in the page translation job. Occasionally, you may want to translate Content Fragments and Experience Fragments exclusively.

Translate Content Fragments

  • Go to your Content Fragments in AEM
  • Select the Content Fragments for translation
  • Click the 3 dots on the top panel > Translate

content-fragment-translate.png

  • This will open the Smartling - Translate dialog 
  • Complete the fields and click Add to job
    • As content fragments do not contain sub-pages, the "Include all sub-pages" checkbox is removed from the Smartling - Translate dialog.

content-fragment-translate-2.png

Translate Experience Fragments

  • Go to your Experience Fragments in AEM
  • Navigate through the source folders to Experience Fragments
  • Click the 3 dots on the top panel > Translate

experience-fragment-translate.png

  • This will open the Smartling - Translate dialog 
  • Complete the fields
    • If your Experience Fragments contains variants that you want to include for translation, select the "Include all sub-pages" checkbox
  • click Add to job.

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 ellipses 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 translation progress once per day, but you can set it to do so more often in the connector configuration. 

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 * ? *"

    cron.png
  4. Save your changes. 

Download Translations

AEM will download translations automatically after all the content in the Translation Project is published in Smartling. There may be a delay after content has been translated as the download process runs in accordance with the Scheduler Cron (once per day). The AEM Cloud 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 added to the new job.
When a page is resubmitted for translation, AEM creates a launch for the language copy. When translations have been downloaded, they are applied to the launch, then AEM promotes the launch to the language copy.

Handle Updates to Translations

You can make the updates to translations in Smartling, then use the Force resubmission (Required if page is unchanged) option to create a new AEM Translation Project to pull back updated translations.

Request Translations by References Panel

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.
  • Choose to enable Auto-authorize by selecting the checkbox.
    • Enabling auto authorize will automatically authorize the Job for translation in Smartling, meaning a user does not have to manually do so.
    • If you unselect the Auto authorize checkbox, the Job will not be authorized automatically. You can decide when to authorize the job as needed.

image__1_.png

Using the Smartling - Translate dialog is the recommended translation method over from Reference panel or manually created projects.

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, unless Authorize Job or Auto authorize checkboxes have been selected.

Was this article helpful?