Use machine translation or human translation to translate a Core Components based Adaptive Form

Last update: June 26, 2024
  • Applies to:
  • Experience Manager as a Cloud Service

CREATED FOR:

  • User
  • Developer

Localized forms help you serve a wider audience across geographies. Adobe Experience Manager translation workflow helps you localize Adaptive Forms and their documents of record . You can use machine translation or human translators to localize an Adaptive Form.

Translate an Adaptive Form and document of record using machine translation

The machine translation service immediately translates your content in Adaptive Form and Document of Record. AEM Forms as a Cloud Service is pre-configured to use a trial version of Microsoft Translator for machine translation. Perform the following steps to enable machine translation for your Adaptive Forms and Document of Record:

  1. On the AEM Forms UI, select a form, and select the Add Dictionary option.

  2. In the Add Dictionary to Translation Project screen, for the Project option

    • To create a translation project, select the Create a new translation project option and in the Project Title field, specify the title. For example, Government Reference Site - German locale.
    • To add a new dictionary to an existing translation project, select the Add to an existing translation project option and select an Existing translation project.

  3. In the Target Languages field, specify a locale (For example, German(de)). You can specify multiple locales. The form is translated to all the locales specified in the Target Languages field. Click Done.

  4. In the Dictionary Added dialog box, click Open Projects.

  5. In the Projects screen, click the created project. For example, click the Government Reference Site - German locale tile.

  6. On the Translation Job tile, click the aem62forms_downarrow icon, and click Start. The status of the tile changes to Draft. On completion of the translation, the status changes to Approved. Refresh the page after a few minutes and verify the status.

    Start Translation

  7. After the status changes to Approved on the Translation Job tile, click the aem62forms_downarrow icon, and click Complete.

  8. To preview the localized form, on the AEM Forms UI, select the localized form. Click Preview >Preview as HTML. Reopen the form after adding the afAcceptLang=<locale code> to the URL off the form. For example, add afAcceptLang=deto open German version of the form.

    NOTE
    • Before opening the localized version of form in the browser window, ensure that the locale of the browser is set to match the locale of the form. For example, if the form is translated to German(de) language then set the locale of the browser to German(de).
    • Adaptive form components do not support right to left (RTL) languages. For example, Hebrew.

Localizing an adaptive form and its document of record using Human Translation

In Human translation the content is sent to a translation provider and translated by professional translators. When complete, the translated content is returned and imported into AEM. When your translation provider is integrated with AEM, content is automatically sent between AEM and the translation provider.

For translation, a dictionary containing files in XLIFF format is shared with the professional translators. The dictionary includes a separate XLIFF file for each locale. Each XLIFF file contains text that is displayed to the end users and placeholders for the corresponding localized text.

Perform the following steps to localize a form and its document of record using Human Translators:

  1. On the AEM Forms UI, select a form, and select the Add Dictionary option.

  2. In the Add Dictionary to Translation Project screen, for the Project option

    • To create a translation project, select the Create a new translation project option and in the Project Title field, specify the title. For example, Government Reference Site - German locale.
    • To add a new dictionary to an existing translation project, select the Add to an existing translation project option and select an Existing translation project.

  3. In the Target Languages field, specify a locale (For example, German(de)). You can specify multiple locales. The form is translated to all the locales specified in the Target Languages field. Click Done.

  4. In the Dictionary Added dialog box, click Open Projects.

  5. In the Projects screen, click the created project. For example, click the Government Reference Site - German locale tile.

  6. At the bottom of the Summary tile, click the ellipses. The Translation Project Properties screen opens.

  7. Open the Advanced tab at the top of the Translation Project Properties screen. For the Translation field, select Human Translation. Click Save & Close at the top of the screen.

  8. On the Translation Job tile, click the aem62forms_downarrow icon, and click Export. On the Export dialog, click the Download Exported File option. It downloads a .zip file.
    Export translation file

  9. Extract the downloaded .zip file. The extracted folder has two files:

    • translation_export_summary.xml
    • [form-fields-file].xml.

  10. Open the [form-fields-file].xml for editing. Add the localized strings and messages for form fields. Save and close the file.

  11. Zip the files the translation_export_summary.xml and [form-fields-file].xml.

  12. On the Translation Job tile, click the aem62forms_downarrow icon, and click Import. Select the archive containing [form-fields-file].xml. with localized strings and messages for form fields.

    Import translation file

  13. To preview the localized form, on the AEM Forms UI, select the localized form. Click Preview >Preview as HTML. Reopen the form after adding the afAcceptLang=<locale code> to the URL off the form. For example, add afAcceptLang=deto open German version of the form.