Integraciones

Adobe Experience Manager - AEM (TMS)

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

Disponible para

  • Plan de empresa

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

Disponible para

  • Plan Enterprise (heredado)

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

Versiones soportadas

El Plugin de Traducción de Phrase para Adobe Experience Manager sigue los mismos períodos de soporte de producto que Adobe Experience Manager. Consulte https://helpx.adobe.com/support/programs/eol-matrix.html para obtener información sobre los períodos de soporte.

Una vez que una versión de Adobe Experience Manager alcanza el final del soporte básico, Phrase ya no mantiene 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 como Servicio en la Nube.

Notas de la versión del plugin

Configuración de Phrase

Configurar 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. 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 influenciada por habilitar/deshabilitar la opción Permitir la carga de contenido externo en los editores en la configuración de Acceso y Seguridad.

Requisitos de Phrase:

  • Pasar a través del firewall de la empresa para acceder a la instalación local.

  • Autenticarse en el entorno de autoría.

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

  • La instalación debe ser accesible desde las siguientes direcciones IP:

    34.243.87.13, 34.248.197.209, 108.129.22.31, 3.248.158.93

  • 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 requeridos para ver páginas no publicadas.

Consejo

Crea un nuevo usuario llamado phrase-preview y agrega el usuario al grupo Autores.

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

  2. Haz clic en Conectores.

    Se abre la página Conectores.

  3. Haz clic en Nuevo conector.

    Se abre la página Crear conector.

  4. Proporciona un nombre para la conexión y cambia el Tipo a Vista previa en vivo de Adobe Experience Manager.

  5. Ingresa el Host.

    Usa la dirección del host de la instalación de Adobe Experience Manager (por ejemplo, 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).

  6. Ingresa el nombre de usuario y la contraseña.

  7. Para modificar enlaces contenidos en el HTML de la página, proporciona regla de reescritura de URL en regexp.

    Ejemplo:

    Para reemplazar un código de localización completo con solo el código de idioma en https://example.org/en-us/images/sample.jpg, encuentra /([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 enlaces en estilos CSS y archivos CSS referenciados (url: ('')) serán reescritos.

  8. Haz clic en Guardar.

    El conector se añade 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.

Configurar flujo de trabajo de traducción

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

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

Si se utilizan versiones heredadas, se necesitará crear y validar un servicio y un portal de solicitudes. Para validar la configuración, sigue estos pasos:

  1. Abre un Proyecto de Traducción incompleto.

  2. Selecciona Exportar del menú del mosaico Trabajo.

  3. Encuentra el archivo .XML que contiene el texto fuente dentro del archivo zip descargado.

  4. En Phrase, navega a los portales de solicitantes utilizados para la integración y abre la URL listada.

  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 como se configuró.

Configuración de AEM

Instalar el Plugin

AEM en las instalaciones locales

  1. Si migras de 6.2 o 6.3 a 6.4 y versiones superiores, elimina todas las configuraciones de Servicios en la Nube heredados de la herramienta de administración de Classic UI (/miscadmin#/etc/cloudservices/memsource-translation)

    Todas las configuraciones desaparecen de Servicios en la Nube heredados > Plugin de Traducción Memsource para AEM.

  2. En Herramientas, Despliegue, ve a Paquetes.

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

  4. Selecciona Cargar paquete y carga el archivo de instalación.

  5. Marca Forzar Carga y envía.

AEM como un Servicio en la Nube

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

  1. Agregar repositorio maven basado en el sistema de archivos local al proyecto de servicio en la nube AEM raíz pom.xml:

    <repositories>
    ...
      <repository>
        <id>project.local</id>
        <nombre>proyecto</nombre>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      </repository>
    ...
    </repositories>
  2. Agregar dependencia de plugin a all/pom.xml:

    <dependencia>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>X.X.X</version>
      <tipo>zip</tipo>
    </dependency>
  3. Agregar bloque embebido a all/pom.xml -> filevault-package-maven-plugin configuración:

    ...
    <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>
         <tipo>zip</tipo>
         <target>/apps/aem-memsource-plugin-packages/application/install</target>
       </embedded>
    ...
  4. Agrega el plugin al repositorio maven local. Ejecuta el siguiente comando desde la raíz del proyecto del servicio en la nube AEM reemplazando el marcador de posición {memsource.plugin.path} con la ruta al plugin (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=./repositorio/ -Dpackaging=zip
    
  5. Establece la versión correcta del plugin en all/pom.xml (por ejemplo, 3.0.1):

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

Configura el Plugin

Se requieren dos configuraciones:

  • Informa al sistema que Phrase existe agregándolo como un Proveedor de Servicio de Traducción especificando cómo conectarse al TMS.

  • Informa a Adobe Experience Manager cuándo y cómo se debe usar Phrase configurando la Configuración de Integración de Traducción.

    Ejemplo:

    Usa Phrase para contenido de alta visibilidad, pero un proveedor de traducción automática para contenido comunitario.

Agrega Phrase como un Proveedor de Servicio de Traducción

Sigue estos pasos:

  1. En Herramientas, General, ve a Navegador 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 para traducción solo automática).

  3. En Servicios en la Nube, ve a Servicios de Traducción en la Nube.

  4. Expande el directorio conf.

  5. Crea una nueva configuración e ingresa 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 están usando una URL personalizada.

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

    Haz clic en Conectar.

  6. Selecciona otras opciones y cierra la configuración.

    • Agrupar todos los trabajos de traducción en un solo proyecto de Phrase 

      Todos los trabajos de traducción dentro de un proyecto AEM también se crearán dentro de un solo proyecto de Phrase.

      Importante

      Esta opción no funciona correctamente si Establecer trabajo como completado una vez pre-traducido y Establecer proyecto como completado una vez que todos los trabajos estén completados están habilitados al mismo tiempo en la configuración del plantilla de proyecto de Phrase.

    • Establecer el estado del trabajo de Phrase en 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, se generan automáticamente análisis cuando se importan los archivos. Los análisis siempre se generan por idioma, independientemente de la configuración de la plantilla del proyecto. 

    • Generar cotizaciones 

      Si se activa la generación automática de análisis, se pueden generar cotizaciones basadas en estos análisis.

Si se utilizan versiones heredadas, también se requerirá información de servicio y portal de solicitudes.

Configurar Integración de Traducción

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

  1. En Herramientas, ve a Servicios en la Nube, haz clic en Servicios de Traducción en la Nube.

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

    • Asegúrese de que Traducir cadenas de componentes y Traducir etiquetas estén desmarcados.

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

    • En la pestaña Activos, establezca el Flujo de trabajo de traducción en No traducir.

  3. Si un proyecto aún contiene activos no traducibles o materiales de referencia, márcalos y elimínalos directamente en Phrase.

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

Configure el proveedor de traducción de Phrase predeterminado con diferentes partes de la taxonomía del sitio. Configure el proveedor en el nodo raíz del sitio. Todas las páginas descendientes heredarán la configuración. Anule la configuración en el nodo que debería usar una configuración de proveedor diferente (por ejemplo, todo el sitio usa 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, seleccione la configuración recién creada como la configuración de nube.

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

Enviar contenido para traducción

Para enviar contenido (Sitios, Activos) para traducción, cree un proyecto de traducción en Adobe Experience Manager. Los proyectos se pueden crear manualmente en la sección de Proyectos 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, siga estos pasos:

  1. Desde la vista Sitios, navegue a la página, selecciónela y abra el Panel de referencias.

  2. Haga clic en Copias de idioma y expanda la sección Crear y traducir en la parte inferior del riel.

  3. Seleccione los idiomas de destino, opcionalmente desmarque Seleccionar todas las subpáginas.

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

    Si hay múltiples idiomas de destino, se creará un proyecto separado para cada idioma.

  5. Ingrese el título del proyecto y haga clic en Crear.

  6. Navegue al proyecto en la sección Proyectos y ábralo.

  7. Haga clic en los puntos suspensivos en la primera ficha para abrir la configuración avanzada del proyecto.

    Si está configurado correctamente, las configuraciones creadas en los pasos anteriores se referencian.

  8. Para enviar un trabajo, seleccione Iniciar en el menú de la ficha del trabajo.

    Se creará un nuevo proyecto en unos minutos.

    • Al importar, se asignan proveedores 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 trabajo es aceptado por un proveedor, el estado del elemento de trabajo de AEM cambia a Traducción en progreso.

    • El estado del elemento de trabajo de AEM cambia a Cancelado si el trabajo es eliminado o cancelado.

    Consejo

    Adobe Experience Manager consulta el estado del trabajo en un horario que se configura en Configuración de la plataforma de traducción accedido a través de Consola web.

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

    Actualizar la página de detalles del proyecto fuerza un pull.

  9. En Phrase, traduzca los trabajos del proyecto y establezca su estado en Completado. Al completarse, 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, y los pasos restantes del flujo de trabajo en Nuevo.

  11. Una vez que un elemento de trabajo de AEM es aceptado, el estado del trabajo se actualiza a Entregado según lo configurado en la configuración del plugin.

Para más detalles sobre la creación de proyectos de traducción utilizando el Panel de Referencias, consulte documentación de Adobe.

Varios

Mapeo de Idiomas Personalizado

AEM en las instalaciones locales

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

El mapeo se aplica tanto a los idiomas de origen como a los de destino.

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

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

  3. Cree un nuevo nodo.

  4. Utilice el código de idioma de Adobe Experience Manager como el Nombre (por ejemplo, zh), mantenga Tipo: nt:unstructured.

  5. Agregar propiedad:

    • Nombre: memsourceLanguage

    • Tipo: Cadena

    • Valor: código de idioma (por ejemplo, zh_tw)

  6. Haga clic en Guardar Todo.

Los códigos de idioma no mapeados se envían tal como están.

AEM como un Servicio en la Nube

Para agregar mapeo de idiomas en AEM Cloud Services, siga estos pasos:

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

  2. Abra el archivo creado y copie 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. Abra el archivo creado y copie 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>

IDs de Proyecto

Una vez que se envía 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 IDs para mostrar en el entorno AEM o en APIs para extender la funcionalidad del plugin.

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