The Memsource Translation Plugin for Adobe AEM follows the same product support periods as Adobe AEM. See https://helpx.adobe.com/support/programs/eol-matrix.html for information on support periods.
Once an AEM version reaches end of core support, Memsource no longer maintains the plugin. The installer will be available but no further improvements or fixes will be implemented.
Plugin version 1.x supports AEM 6.3
Plugin version 2.x supports AEM 6.4 and 6.5.
The In-context Preview feature offers a real-time preview of original or translated text in both the Memsource Editor for Web and Memsource Editor for Desktop.
In order for Memsource to offer the real-time preview, it must have access to unpublished pages in an on-premise AEM author node.
Memsource Requirements:
Pass through the enterprise firewall to access the on-premise AEM installation
Authenticate into the AEM authoring environment
Firewall Configuration:
-
AEM installation must be accessible from the following IP addresses:
34.243.87.13, 34.248.197.209, 108.129.22.31, 3.248.158.93
AEM domain name must be able to be resolved externally.
Pre-requisite: Create an AEM user with minimum permissions required to view unpublished pages.
From the Setup
page, scroll down to the Integrations section.-
Click on Connectors.
The Connectors page opens.
-
Click New.
The Create Connector page opens.
Provide a name for the connection and change the Type to Adobe Experience Manager Live Preview.
-
Enter the Host.
Use the host address of the AEM installation (e.g., https://aem-author.example.org/).
The domain name must be resolvable externally (not an intranet domain).
Enter the AEM Username and Password.
-
Click Save.
The connector is added to the list on the Connectors page.
Note
Some HTML tags present a risk and the Memsource Editors remove them from this HTML when displaying the preview. This is to ensure user's data privacy and security.
Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.
Memsource provides a highly-configurable workflow engine allowing associations with AEM jobs, specific net rates schemes, due dates schemes, price lists, workflows steps and more.
To configure AEM job processing, follow these steps:
-
Create a Project Template configured on your needs.
Under Access and Security set the Allow loading external content in editors.
Apply the following XML File Import Settings:
-
Create a Service.
Select the same source and target languages as in AEM.
Select the project template configured in the previous step.
-
Create an Automation Widget.
Select the service created in the previous step.
Don't select the AEM connector configuration in the Connectors combo.
To validate the Memsource configuration, follow these steps:
Open an incomplete AEM Translation Project.
Select Export form the Job tile menu.
Find the XML file that contains the source text within the downloaded zip file.
In Memsource, navigate to the Automation Widget used for the integration and open the listed URL.
Complete the AW form, upload the XML file, validate the email and submit.
Verify the new project was created from the Project template as configured.
-
If migrating from AEM 6.2 or 6.3 to 6.4 and above, remove all Legacy Cloud Services configurations from the Classic UI Admin tool (/miscadmin#/etc/cloudservices/memsource-translation)
All configurations disappear from Legacy Cloud Services > Memsource Translation Plugin for AEM.
In Tools, Deployment, go to Packages.
Uninstall previous version of the plugin, if applicable.
Select Upload package and upload the installation file.
Check Force Upload and submit.
Two configurations are required:
Tell the system that Memsource exists by adding it as a Translation Service Provider specifying how to connect to the TMS.
Tell AEM when and how Memsource is to be used by configuring Translation Integration Configuration. For example: use Memsource for high-visibility content, but a machine translation vendor for community content.
Follow these steps:
AEM 6.4, 6.5
In Tools, go to Cloud Services, click Translation Cloud Services.
In Tools, General, go to Configuration Browser.
Create a configuration container for each Memsource service (e.g. one configuration for human translation and a separate configuration for machine-only translation).
In Cloud Services, go to Translation Cloud Services.
-
Expand the conf directory.
The configuration containers created in the previous step are listed.
AEM 6.3
In Tools, go to Deployment, click on Cloud Services, and navigate to Memsource Translation Plugin for AEM.
Create a new configuration and enter the following information:
Memsource Home URL: The default URL is https://cloud.memsource.com/web/ but can be different if you or the LSP is using a Custom URL.
Username and Password.
Automation Widget: Select the Automation Widget prepared for use in AEM. If using multiple Automation Widgets for different scenarios, set up multiple configurations.
Service: Select the service that governs the language setup of projects (orders) in Memsource as well as the Workflow setup of these Memsource projects.
-
Autocomplete Job: Select if the AEM Translation Jobs is to skip the Review step.
In version 6.5, equivalent configuration is available in translation project advanced settings.
AEM URL: Use the same host address of the AEM installation used in the Memsource connector and append with /sites.html/content/ (e.g. https://aem-author.example.org/sites.html/content/).
When using the Memsource Translation Plugin for AEM, all files in the translation jobs are submitted for translation and thus returned from Memsource. Use the project Translation Integration configuration to prevent non-translatable assets or reference materials from being included in the projects.
-
AEM 6.4, 6.5
In Tools, go to Cloud Services, click Translation Cloud Services.
AEM 6.3
In Tools, go to Deployment, click on Cloud Services, and select Translation Integration.
-
Create a new configuration specifically for translation in Memsource.
Ensure Translate Component Strings and Translate Tags are unchecked.
Set Translate page assets to Do not translate.
On the Assets Tab, set the Translation Workflow to Do not translate.
If a project still contains non-translatable assets or reference materials, mark and delete them directly in Memsource.
Configure default Memsource Translation Provider with different parts of the site taxonomy. Configure the provider at the root node of the site. All descendant pages will inherit the setting. Override the setting at the node that should use different provider configuration (e.g. entire site uses human translation but the community section uses machine translation).
To apply translation integration, follow these steps:
AEM 6.4, 6.5
On the Advanced Tab, select the newly created configuration as the Cloud Configuration.
AEM 6.3
On the Cloud Services Tab, select the newly created configuration as the Translation Integration.
-
Click on the Add configuration label and select the Memsource Translation Plugin for AEM.
A dropdown menu is displayed with previously created configurations.
-
Select the configuration for use with this content.
By default, all child pages inherit these settings. Adjust any page to use a different cloud configuration if required.
When adding content from these pages, only translatable content will be added. If a project is created from the References Panel, it will be automatically set up to use the cloud configuration associated with the root page.
Memsource Home URL: The default URL is https://cloud.memsource.com/web/ but can be different if you or the LSP is using a Custom URL.
To submit content for translation, create a translation project in AEM. Projects can be created manually in the Projects section or use built-in AEM workflows to minimize the effort.
To prepare a project for submission to Memsource through the built-in workflows, follow these steps:
From the Sites view, navigate to the page, select it, and open the References Panel.
Click Language Copies and expand the Create & Translate section at the bottom of the rail.
Select target languages, optionally uncheck the Select all sub-pages.
-
Select the appropriate option from the Project dropdown:
AEM 6.4, 6.5
Select Create Multi-language Translation Project.
A single project is created with multiple jobs (one per language) if there are multiple target languages.
AEM 6.3
Select Create a new translation project.
If there are multiple target languages, a separate project will be created for each language.
Enter project title and click Create.
Navigate to the project in the Projects section and open it.
-
Click the ellipsis on the first tile to open the Advanced project settings.
If configured properly, configurations created in the steps above are referenced.
-
To submit a job to Memsource, select Start from the job tile menu.
A new project will be created in Memsource within a few minutes.
Tip
AEM polls for a job status update on a schedule that is configured in Translation Platform Configuration accessed via Web Console.
Setting the Scheduler Cron property to run frequently (e.g.
0 0/5 * * * ? *triggers a translation job status refresh every 5 minutes).Refreshing the project detail page forces an AEM pull.
In Memsource, translate the product jobs and set their status to Completed.
If not set automatically in Memsource project automation settings, set the project status to Completed.
If the Autocomplete Jobs in the Memsource configuration is turned on, the AEM Translation Job status will change to Ready for Review within minutes. The status then changes to Completed.
If rejected, the job is submitted back to Memsource with comments. The job status in Memsource changes to Rejected and the comments appear in the rejected job email. Format of the CMS Job Rejected email can be customized in Email Templates settings.
Once all files in the AEM job are accepted, the status changes to Completed.
For more details on creating translation projects using the References Panel, see Adobe documentation.
To map AEM languages to different languages in Memsource (e.g. zh to zh_tw), follow these steps.
The mapping applies to both source and target languages.
Open CRXDE (
/crx/de/index.jsp).Browse to the
/apps/memsource-connector/language-mapping/folder.Create a new node.
Use AEM language code as the Name (e.g. zh), keep Type: nt:unstructured.
-
Add property:
Name: memsourceLanguage
Type: String
Value: Memsource language code (e.g. zh_tw)
Click Save All.
Un-mapped language codes are sent to Memsource as they are.
Comments
Article is closed for comments.