Integraciones
    1. Phrase
    2. Phrase TMS
    3. Integraciones

    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. Consulte 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:

    • Atraviesa el 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 Direcciones IP de los servidores de Phrase 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: Crea un usuario de Adobe Experience Manager con los permisos mínimos necesarios para ver páginas no publicadas.

    Consejo

    Crea un nuevo usuario llamado phrase-preview y añade el usuario al grupo Autores.

    1. En la página Configuración Setup_gear.png, baja hasta la sección Integraciones.

    2. Haz clic en Conectores.

      Se abrirá la página Conectores.

    3. Haz clic en Nuevo conector.

      Se abrirá la página Crear conector.

    4. Cambia el Tipo a Adobe Experience Manager Live Preview y proporciona un nombre para el conector.

    5. Opcionalmente, habilita Forzar conexión segura.

    6. 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 ser resoluble externamente (no un dominio de intranet).

    7. Introduce el Nombre de usuario de vista previa en vivo y la Contraseña de vista previa en vivo.

    8. Para modificar los enlaces contenidos en el HTML de la página, proporciona una regla de reescritura de URL en regex.

      Ejemplo:

      Para reemplazar un código de configuración regional 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 los enlaces en estilos CSS y archivos CSS referenciados (url: ('')) serán reescritos.

    9. Haz clic en Guardar.

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

    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.

    Configura el flujo de trabajo de traducción

    Para configurar el procesamiento de trabajos de Adobe Experience Manager, crea una plantilla de proyecto configurada según tus necesidades:

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

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

    1. Abre un proyecto de traducción incompleto.

    2. Selecciona Export en el menú del mosaico Job.

    3. Busca el archivo .XML que contiene el texto de origen dentro del archivo zip descargado.

    4. En Phrase, navega a los Submitter portals utilizados para la integración y abre la URL indicada.

    5. Completa el formulario SP, carga el archivo .XML, valida el correo electrónico y envía.

    6. Verifica que el nuevo proyecto se haya creado a partir de la plantilla de proyecto según lo configurado.

    Configuración de AEM

    Instalar el plugin

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

    AEM en las instalaciones

    1. Si migras de la versión 6.2 o 6.3 a la 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.

    2. En Tools, Deployment, ve a Packages.

    3. Desinstala la versión anterior del plugin, si corresponde.

    4. Selecciona Upload package y carga el archivo de instalación.

    5. Marca Force Upload y envía.

    AEM como servicio en la nube

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

    1. Agrega un 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>proyecto</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
  repositorio

repositories {

    2. Agrega la dependencia del plugin a all/pom.xml:

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

    3. 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>

    4. Agrega el complemento al repositorio local de Maven. Ejecuta el siguiente comando desde la raíz del proyecto del 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

    5. Establece la versión correcta del complemento en all/pom.xml (por ejemplo, 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 agregá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 se debe utilizar Phrase configurando la Configuración de integración de traducción.

      Ejemplo:

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

    Agrega Phrase como proveedor de servicios de traducción

    Siga estos pasos:

    1. En Herramientas, General, ve al Explorador de configuración.

    2. Crea un contenedor de configuración para cada servicio de Phrase (por ejemplo, una configuración para traducción humana y una configuración separada solo para traducción automática).

    3. En Cloud Services, ve a Translation Cloud Services.

    4. Expande el directorio conf.

    5. Crea una nueva configuración e introduce la siguiente información:

      • Nombre de host: La URL predeterminada es https://cloud.memsource.com/web/ pero puede ser diferente si usted o el LSP utiliza una URL personalizada.

      • Nombre de usuario y Contraseña (debe tener un rol de PM con la opción Modificar configuración global del servidor habilitada en los derechos de usuario).

      Haz clic en Conectar.

    6. 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 la configuración de la plantilla de proyecto de Phrase.

      • Establece el estado del trabajo de Phrase como Entregado después de la importación a AEM 

      • Generar análisis 

        Si está activo, una vez que se envía 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 utiliza versiones heredadas, también se requerirá información de servicio y del 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 no traducibles o materiales de referencia en los proyectos.

    1. En Herramientas, ve a Servicios en la nube, y haz clic en Servicios en la nube de traducción.

    2. Crea una nueva configuración específicamente para la traducción.

      Nota

      Crea la configuración en conf. Las entradas en /libs son valores predeterminados de Adobe de solo lectura.

      • Asegúrate de que Traducir cadenas de componentes y Traducir etiquetas estén desmarcadas.

      • Establece Traducir activos de página en No traducir.

      • En la pestaña Assets, establece el Translation Workflow en No traducir.

    3. Si un proyecto todavía contiene activos no traducibles o materiales de referencia, márquelos y elimínelos 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 utilizar una configuración de proveedor diferente (por ejemplo, todo el sitio utiliza traducción humana, pero la sección de la comunidad utiliza traducción automática).

    Para aplicar la integración de traducción:

    • En la pestaña Advanced, selecciona la configuración recién creada como Configuración en la nube.

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

    Envía contenido para traducción

    Para enviar contenido (sitios, activos) para su traducción, crea un proyecto de traducción en Adobe Experience Manager. Los proyectos pueden crearse manualmente en la sección Proyectos o utilizar 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:

    1. Desde la vista Sites, navega hasta la página, selecciónala y abre el References Panel.

    2. Haz clic en Language Copies y expande la sección Create & Translate en la parte inferior de la barra lateral.

    3. Selecciona los idiomas de destino y, opcionalmente, desmarca Select all sub-pages.

    4. Selecciona Crear proyecto de traducción multilingüe.

      Si hay varios idiomas de destino, se creará un proyecto independiente para cada idioma.

    5. Ingresa el título del proyecto y haz clic en Crear.

    6. Navega hasta el proyecto en la sección Proyectos y ábrelo.

    7. Haz clic en los puntos suspensivos del primer mosaico para abrir la configuración avanzada del proyecto.

      Si se configuran correctamente, se hace referencia a las configuraciones creadas en los pasos anteriores.

    8. Para enviar un trabajo, selecciona Iniciar en el menú del mosaico de trabajo.

      Se creará un nuevo proyecto en unos minutos.

      • Tras la importación, los proveedores se asignan desde la plantilla del proyecto y el estado del elemento de trabajo de AEM se establece en Comprometido para traducción.

      • Una vez que el proveedor acepta el trabajo, el estado del elemento de trabajo de AEM cambia a Traducción en curso.

      • El estado del elemento de trabajo de AEM cambia a Cancelado si el trabajo se elimina o se cancela.

      Consejo

      Adobe Experience Manager consulta el estado del 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 la Consola web.

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

      Al actualizar la página de detalles del proyecto se activa una extracción de datos.

    9. En Phrase, traduce los trabajos del proyecto y establece su estado en Completado. Una vez completados, los trabajos se importan de nuevo a AEM.

    10. 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.

    11. 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 la creación de proyectos de traducción mediante el Panel de referencias, consulte la documentación de Adobe.

    Misceláneos

    Asignación de idioma personalizada

    AEM en las instalaciones

    Para asignar idiomas de Adobe Experience Manager a diferentes idiomas en Phrase (p. ej., zh a zh_tw), siga estos pasos.

    La asignación se aplica tanto al idioma de origen como al de destino.

    1. Abra CRXDE (/crx/de/index.jsp).

    2. Navegue a la carpeta /apps/memsource-connector/language-mapping/.

    3. Cree un nodo nuevo.

    4. Usa el código de idioma de Adobe Experience Manager como Name (p. ej., zh), y mantén Type: nt:unstructured.

    5. Añade la propiedad:

      • Name: memsourceLanguage

      • Tipo cadena

      • Value: código de idioma (p. ej., zh_tw)

    6. Haz clic en Save All.

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

    AEM como servicio en la nube

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

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

    2. 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"/>

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

    4. 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>

    5. Agrega 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 los 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.

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

    Solución de problemas de AEM

    Problema

    Causas

    Solución

    Cloud Manager informa una alerta de "Consulta sin índice" para una consulta en translationObjectID bajo /content/projects

    El conector de AEM de Phrase 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 as a Cloud Service no puede indexarlo de antemano y recurre a un recorrido completo, lo cual marca Cloud Manager.

    Agrega una definición de índice Oak/Lucene personalizada de tipo oak:QueryIndexDefinition, con alcance en /content/projects y con un índice de propiedad sobre 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 no productivo antes de desplegarla en producción. Limita el ámbito del índice a la estructura de carpetas del proyecto en la instancia de AEM, restringiéndolo a carpetas específicas siempre que sea posible en lugar de indexar todo /content/projects, ya que un índice con un ámbito demasiado amplio puede afectar el rendimiento. Después del despliegue, AEM pone la propiedad reindex de la definición del índice en false una vez que finaliza la reindexación, lo que confirma que se terminó sin errores y no requiere ninguna acción adicional.

    La compilación de Maven falla con errores de validación de filevault-package-maven-plugin como “Package of type ‘APPLICATION’ is not supposed to contain any sub packages” o “Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations”.

    En las versiones 3.1.18.6 y anteriores del complemento, los paquetes OSGi y los archivos de configuración se empaquetan dentro de un paquete de tipo aplicación, que la validación de AEM as a Cloud Service rechaza.

    Actualiza a la versión 3.1.18.7 o posterior. Elimina skipSubPackageValidation de la configuración de Maven si se añadió como solución alternativa.

    Phrase no aparece en la lista bajo /libs en Translation Cloud Services.

    Las entradas bajo /libs son valores predeterminados de Adobe de solo lectura. El complemento almacena su configuración bajo /conf, /apps/aem-memsource-plugin y /var/memsource-tms.

    Crea la configuración de integración de traducción bajo conf. La conexión del servidor se almacena por separado en /conf/global/settings/cloudconfigs/translation/memsource-translation.
    ¿Fue útil este artículo?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.