Adobe Experience Manager - AEM (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Disponible para

Plan empresarial

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Disponible para

Plan Enterprise (anterior)

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Versiones compatibles

El plugin de traducción de Phrase para Adobe Experience Manager sigue los mismos periodos de soporte de producto que Adobe Experience Manager. Consulta https://helpx.adobe.com/support/programs/eol-matrix.html para obtener información sobre los periodos de soporte.

Una vez que una versión de Adobe Experience Manager llega al final del soporte principal, Phrase deja de mantener el plugin. El instalador estará disponible, pero no se implementarán más mejoras ni correcciones.

La versión 2.x del plugin es compatible con 6.5.
La versión 3.x del plugin es compatible con AEM as a Cloud Service.

Notas de la versión del plugin

Configuración de Phrase

Configurar la vista previa en contexto

La función de vista previa en contexto ofrece una vista previa en tiempo real del texto original o traducido tanto en el editor web CAT como en el editor de escritorio CAT.

Se admiten tablas, columnas, varios gráficos, formato y fuentes (si son instaladas por los usuarios). La función está destinada a proporcionar contexto al traducir y no es una representación perfecta del documento original o completado; se esperan algunas diferencias visuales. También puede verse afectada si se habilita o se deshabilita la opción Permitir la carga de contenido externo en los editores en la configuración de acceso y seguridad.

Requisitos de Phrase:

Pasa a través del firewall empresarial para acceder a la instalación local.
Autentícate en el entorno de creación.

Configuración del firewall para la instalación local:

La instalación debe ser accesible desde las direcciones IP del servidor de Phrase. Consulta Phrase Servers IP Addresses para obtener la lista actual.
El nombre de dominio debe poder resolverse externamente.

Nota

Algunas etiquetas HTML presentan un riesgo y el editor CAT las elimina de este HTML al mostrar la vista previa. Esto es para garantizar la privacidad y seguridad de los datos del usuario.

Ejemplos de etiquetas eliminadas incluyen FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT o propiedades CSS de background-image.

Configuración de Phrase TMS

Requisito previo: Cree un usuario de Adobe Experience Manager con los permisos mínimos necesarios para ver páginas no publicadas.

Consejo

Cree un nuevo usuario llamado phrase-preview y añada el usuario al grupo Authors.

En la página Configuración , baja hasta la sección Integraciones.
Haz clic en Conectores.

Se abrirá la página Conectores.
Haz clic en Nuevo conector.

Se abrirá la página Crear conector.
Cambia el Tipo a Adobe Experience Manager Live Preview y proporciona un nombre para el conector.
Introduce el Host.

Utiliza la dirección de host de la instalación de Adobe Experience Manager (p. ej., https://aem-author.example.org/ o https://author-X-Y.adobeaemcloud.com/).

El nombre de dominio debe poder resolverse externamente (no un dominio de intranet).
Introduce el nombre de usuario y la contraseña.

El inicio de sesión único (SSO) y la autenticación de dos factores (2FA) no se admiten. Si se aplica SSO o 2FA en la cuenta de Drupal, usa una cuenta de servicio dedicada exenta de ambos requisitos.
Para modificar los enlaces contenidos en el HTML de la página, proporciona URL rewrite rule en regex.

Ejemplo:

Para reemplazar un código de locale completo solo con el código de idioma en https://example.org/en-us/images/sample.jpg, busca /([a-z]{2})-[a-z]{2}/ y reemplázalo con /$1/.

Los enlaces en las etiquetas <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" y en los estilos CSS y archivos CSS referenciados (url: ('')) se reescribirán.
Haz clic en Guardar.

El conector se añadirá a la lista de la página Conectores.

Eliminar un Conector

Para eliminar un Conector:

Desde la página Integrations, selecciona el conector que deseas eliminar.
Haz clic en Delete.

Se abre la ventana Eliminar Conector.
Escribe "delete" y haz clic en Delete.

El Conector se elimina y se muestra la lista de conectores.

Nota

Un conector no se puede eliminar mientras esté vinculado a trabajos incompletos en un proyecto, incluidos aquellos que se encuentran en la papelera de reciclaje. Intentar eliminar dicho conector devuelve un error de "Error al eliminar el conector".

Resolución Abre el proyecto asociado con el conector y completa o elimina cualquier trabajo pendiente. Ve a Configuración/Papelera de reciclaje y vacíala para eliminar cualquier trabajo aún vinculado al conector. Vuelve a intentar eliminar el conector.

Nota

Algunas etiquetas HTML presentan un riesgo y el editor CAT las elimina de este HTML al mostrar la vista previa. Esto es para garantizar la privacidad y la seguridad de los datos del usuario.

Ejemplos de etiquetas eliminadas incluyen FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT o propiedades CSS de background-image (imagen de fondo).

Configurar Flujo de trabajo de traducción

Para configurar el procesamiento de trabajos de Adobe Experience Manager, cree una plantilla de proyecto configurada a sus necesidades:

En Acceso y seguridad, activa la opción Permitir la carga de contenido externo en el editor CAT de Phrase.

Si usas versiones anteriores, tendrás que crear y validar un servicio y un portal de envío. Para validar la configuración, sigue estos pasos:

Abre un proyecto de traducción incompleto.
Selecciona Export en el menú del mosaico Job.
Busca el archivo .XML que contiene el texto fuente dentro del archivo zip descargado.
En Phrase, navega a los Submitter portals utilizados para la integración y abre la URL indicada.
Completa el formulario SP, carga el archivo .XML, valida el correo electrónico y envíalo.
Verifica que el nuevo proyecto se haya creado a partir de la plantilla de proyecto tal como se configuró.

Configuración de AEM

Instalar el complemento

Descarga el paquete del complemento más reciente desde la página Phrase Ecosystem en Phrase usando el botón Download. El complemento solo está disponible para las organizaciones que lo hayan adquirido.

AEM en las instalaciones

Si migras de 6.2 o 6.3 a 6.4 o superior, elimina todas las configuraciones de Legacy Cloud Services de la herramienta de administración de la interfaz clásica (/miscadmin#/etc/cloudservices/memsource-translation).

Todas las configuraciones desaparecen de Legacy Cloud Services > Memsource Translation Plugin for AEM.
En Herramientas, Implementación, ve a Paquetes.
Desinstala la versión anterior del complemento, si corresponde.
Selecciona Upload package y carga el archivo de instalación.
Marca Force Upload y envía.

AEM como servicio en la nube

Si el complemento ya está instalado, salta al paso 4.

Agrega el repositorio Maven basado en el sistema de archivos local a la raíz del proyecto de servicio en la nube de AEM pom.xml:

repositories {
{
  repositorio
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  repositorio
{
repositories {

Agrega la dependencia del complemento a all/pom.xml:

<dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>X.X.X</version>
  <type>zip</type>
</dependency>

Añade el bloque incrustado a la configuración de all/pom.xml -> filevault-package-maven-plugin:

{
plugin
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  Configuración
  <group>my_packages</group>
  <embeddeds>
   <embedded>
     <groupId>com.memsource</groupId>
     <artifactId>aem-memsource-plugin.all</artifactId>
     <type>zip</type>
     <target>/apps/aem-memsource-plugin-packages/application/install</target>
   </embedded>
{

Agrega el complemento al repositorio local de Maven. Ejecuta el siguiente comando desde la raíz del proyecto de servicio en la nube de AEM reemplazando el marcador de posición {memsource.plugin.path} con la ruta al complemento (por ejemplo, /tmp/aem-memsource-plugin.all-3.0.1.zip):
```
mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip
```

Establece la versión correcta del plugin en all/pom.xml (p. ej., 3.0.1):

<dependency>
  <groupId>com.memsource</groupId>
  <artifactId>aem-memsource-plugin.all</artifactId>
  <version>3.0.1</version>
  <type>zip</type>
</dependency>

Configura el complemento

Se requieren dos configuraciones:

Indica al sistema que Phrase existe añadiéndolo como proveedor de servicios de traducción y especificando cómo conectarse al TMS.
Indica a Adobe Experience Manager cuándo y cómo debe utilizarse Phrase configurando la Configuración de integración de traducción.

Ejemplo:

Usa Phrase para contenido de alta visibilidad, pero recurre a un proveedor de traducción automática para contenido de la comunidad.

Añade Phrase como proveedor de servicios de traducción

Sigue estos pasos:

En Herramientas, General, ve a Explorador de configuración.
Crea un contenedor de configuración para cada servicio de Phrase (p. ej., una configuración para traducción humana y otra para traducción solo automática).
En Servicios en la nube, ve a Servicios de traducción en la nube.
Expande el directorio conf.
Crea una configuración nueva e introduce la siguiente información:
- Nombre de host: La URL predeterminada es https://cloud.memsource.com/web/, pero puede ser diferente si tú o el LSP usas una URL personalizada.
- Nombre de usuario y Contraseña (debes estar en un rol de PM con la opción Modificar ajustes globales del servidor habilitada en los derechos del usuario).
Haz clic en Conectar.
Selecciona otras opciones y cierra la configuración.
- Agrupa todos los trabajos de traducción en un único proyecto de Phrase
  
  Todos los trabajos de traducción dentro de un proyecto de AEM también se crearán dentro de un proyecto de Phrase.
  
  Importante
  
  Esta opción no funciona correctamente si Establecer trabajo como completado una vez pretraducido y Establecer proyecto como completado una vez que todos los trabajos estén completados están habilitados al mismo tiempo en los ajustes de plantilla de proyecto de Phrase.
- Establece el estado del trabajo de Phrase como Entregado tras la importación a AEM
- Generar análisis
  
  Si está activa, una vez enviado un trabajo de traducción, los análisis se generan automáticamente cuando se importan los archivos. Los análisis siempre se generan por idioma, independientemente de la configuración de la plantilla del proyecto.
- Genera presupuestos
  
  Si la generación automática de análisis está activada, se pueden generar presupuestos basados en estos análisis.

Si usas versiones anteriores, también se requiere información de servicio y portal del remitente.

Configura la integración de traducción

Al utilizar el complemento de traducción de Phrase para AEM, todos los archivos de los trabajos de traducción se envían para su traducción y, por lo tanto, se devuelven desde Phrase. Utiliza la configuración de Integración de traducción del proyecto para evitar que se incluyan activos o materiales de referencia no traducibles en los proyectos.

En Herramientas, ve a Servicios en la nube y haz clic en Servicios de traducción en la nube.
Crea una nueva configuración específicamente para la traducción.
- Asegúrate de que Traducir cadenas de componentes y Traducir etiquetas estén desmarcadas.
- Establece Traducir recursos de página en No traducir.
- En la pestaña Recursos, establece el Flujo de trabajo de traducción en No traducir.
Si un proyecto aún contiene recursos o materiales de referencia no traducibles, márcalos y elimínalos directamente en Phrase.

Aplica la integración de traducción a los sitios

Configura el proveedor de traducción de Phrase predeterminado con diferentes partes de la taxonomía del sitio. Configura el proveedor en el nodo raíz del sitio. Todas las páginas descendientes heredarán la configuración. Anula la configuración en el nodo que deba usar una configuración de proveedor diferente (por ejemplo, todo el sitio utiliza traducción humana, pero la sección de la comunidad usa traducción automática).

Para aplicar la integración de traducción:

En la pestaña Avanzado, selecciona la configuración recién creada como configuración de la nube.

Al añadir contenido de estas páginas, solo se añadirá el contenido traducible. Si se crea un proyecto desde el Panel de referencias, se configurará automáticamente para utilizar la configuración de la nube asociada a la página raíz.

Envía contenido para traducción

Para enviar contenido (sitios, recursos) para su traducción, crea un proyecto de traducción en Adobe Experience Manager. Puedes crear proyectos manualmente en la sección Projects o usar flujos de trabajo integrados para minimizar el esfuerzo.

Para preparar un proyecto para su envío a través de los flujos de trabajo integrados, sigue estos pasos:

Desde la vista Sites, navega hasta la página, selecciónala y abre el Panel de referencias.
Haz clic en Language Copies y expande la sección Create & Translate en la parte inferior del panel lateral.
Selecciona los idiomas de destino y, opcionalmente, desmarca Select all sub-pages.
Selecciona Create Multi-language Translation Project.

Si hay varios idiomas de destino, se creará un proyecto independiente para cada idioma.
Introduce el título del proyecto y haz clic en Create.
Navega hasta el proyecto en la sección Projects y ábrelo.
Haz clic en los puntos suspensivos del primer mosaico para abrir la configuración avanzada del proyecto.

Si se configura correctamente, se hace referencia a las configuraciones creadas en los pasos anteriores.
Para enviar un trabajo, selecciona Start en el menú del mosaico del trabajo.

Se creará un nuevo proyecto en pocos minutos.
- Tras la importación, se asignan los proveedores a partir de la plantilla del proyecto y el estado del elemento de trabajo de AEM se establece en Committed for translation.
- Una vez que el proveedor acepta el trabajo, el estado del elemento de trabajo de AEM cambia a Translation in progress.
- El estado del elemento de trabajo de AEM cambia a Cancelled si el trabajo se elimina o se cancela.
Consejo

Adobe Experience Manager consulta el estado de un trabajo según una programación configurada en Configuración de la plataforma de traducción, a la que se accede a través de Consola web.

Configurar la propiedad Programador Cron para que se ejecute con frecuencia (por ejemplo, 0 0/5 * * * ? * activa una actualización del estado del trabajo de traducción cada 5 minutos).

Actualizar la página de detalles del proyecto fuerza una actualización.
En Phrase, traduce los trabajos del proyecto y establece su estado en Completado. Una vez completados, los trabajos se importan de nuevo a AEM.
Si se rechaza, el primer paso del flujo de trabajo del trabajo se establece en Enviado por correo electrónico, y los pasos restantes del flujo de trabajo en Nuevo.
Una vez que se acepta un elemento de trabajo de AEM, el estado del trabajo se actualiza a Entregado según lo configurado en la configuración del complemento.

Para obtener más detalles sobre cómo crear proyectos de traducción utilizando el panel de referencias, consulta la documentación de Adobe.

Varios

Asignación de idioma personalizada

AEM en las instalaciones

Para asignar idiomas de Adobe Experience Manager a diferentes idiomas en Phrase (por ejemplo, zh a zh_tw), sigue estos pasos.

La asignación se aplica tanto a los idiomas de origen como a los de destino.

Abre CRXDE (/crx/de/index.jsp).
Ve a la carpeta /apps/memsource-connector/language-mapping/.
Crea un nuevo nodo.
Usa el código de idioma de Adobe Experience Manager como Nombre (por ejemplo, zh) y mantén Tipo: nt:unstructured.
Añade la propiedad:
- Nombre: memsourceLanguage
- Tipo Cadena
- Valor: código de idioma (por ejemplo, zh_tw)
Haz clic en Guardar todo.

Los códigos de idioma no asignados se envían tal cual.

AEM como servicio en la nube

Para agregar una asignación de idioma en AEM Cloud Services, sigue estos pasos:

Crea un archivo .content.xml en la carpeta /conf/aem-memsource-plugin/language-mapping/.

Abre el archivo creado y copia lo siguiente en él:

<?xml version="1.0" encoding="utf-8"?>
<jcr:root xmlns:sling=\"http://sling.apache.org/jcr/sling/1.0\" xmlns:jcr=\"http://www.jcp.org/jcr/1.0\"
    jcr:primaryType=\"sling:Folder\"/>

Crea un archivo .content.xml en la carpeta /conf/aem-memsource-plugin/language-mapping/zh-cn.

Abre el archivo creado y copia lo siguiente en él:

<?xml version="1.0" encoding="utf-8"?>
<jcr:root xmlns:jcr=\"http://www.jcp.org/jcr/1.0\"
          jcr:primaryType=\"nt:unstructured\"
          memsourceLanguage=\"zh_cn\">
</jcr:root>

Agregue las rutas creadas en los pasos anteriores al archivo filter.xml que se encuentra en ui.content/src/main/content/META-INF/vault/filter.xml:

<?xml version="1.0" encoding="utf-8"?>
<workspaceFilter version=\"1.0\">
{
    <filter root=\"/conf/aem-memsource-plugin\" mode=\"update\"/>
    <filter root=\"/conf/aem-memsource-plugin/language-mapping\" mode=\"update\"/>
</workspaceFilter>

ID de proyectos

Una vez enviado un trabajo de traducción, el ID del proyecto y el UID se almacenan en /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob como propiedades PROPERTY_MEMSOURCE_PROJECT_ID y PROPERTY_MEMSOURCE_PROJECT_UID.

Utiliza los ID para mostrarlos en el entorno de AEM o en las API para ampliar la funcionalidad del complemento.

Solución de problemas de AEM

Problema	Causas	Solución
Cloud Manager informa de una alerta de "Consulta sin índice" para una consulta en `translationObjectID` bajo `/content/projects`	El conector de Phrase AEM localiza los nodos de trabajo de traducción mediante un `translationObjectID` asignado en tiempo de ejecución. Este identificador no existe como una propiedad de repositorio preexistente, por lo que AEM como servicio en la nube no puede indexarlo por adelantado y recurre a un recorrido completo, lo que Cloud Manager señala.	Añade una definición de índice Oak/Lucene personalizada de tipo `oak:QueryIndexDefinition`, con ámbito en `/content/projects`, con un índice de propiedad en `translationObjectID`. Implementa la definición del índice a través de la canalización de código en lugar de crearla en tiempo de ejecución, y valídala en un entorno que no sea de producción antes de implementarla en producción. Limita el índice a la estructura de carpetas del proyecto en la instancia de AEM, restringiéndolo a carpetas de proyecto específicas siempre que sea posible en lugar de indexar todo `/content/projects`, ya que un índice con un ámbito demasiado amplio puede generar su propio impacto en el rendimiento. Tras la implementación, AEM establece la propiedad `reindex` de la definición del índice en `false` una vez que se complete la reindexación, lo que confirma que ésta finalizó sin errores y no requiere ninguna acción adicional.

Adobe Experience Manager - AEM (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Disponible para

Disponible para

Versiones compatibles

Configuración de Phrase

Configurar la vista previa en contexto

Nota

Configuración de Phrase TMS

Consejo

Eliminar un Conector

Nota

Nota

Configurar Flujo de trabajo de traducción

Configuración de AEM

Instalar el complemento

AEM en las instalaciones

AEM como servicio en la nube

Configura el complemento

Añade Phrase como proveedor de servicios de traducción

Importante

Configura la integración de traducción

Aplica la integración de traducción a los sitios

Envía contenido para traducción

Consejo

Varios

Asignación de idioma personalizada

AEM en las instalaciones

AEM como servicio en la nube

ID de proyectos

Solución de problemas de AEM