Integraciones

Adobe Experience Manager - AEM (TMS)

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

Disponible para

  • Plan Enterprise

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 alcanza el fin 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 CAT Web Editor como en el CAT Desktop Editor.

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:

  • Atraviese el firewall de Enterprise para acceder a la instalación local.

  • Autentíquese 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. Consulte 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 CAT Editor 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: Crear 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 agregue 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 abrirá la página Conectores.

  3. Haz clic en Nuevo conector.

    Se abrirá la página Crear conector.

  4. Cambie el Tipo a Adobe Experience Manager Live Preview y proporcione un nombre para el conector.

  5. Introduzca el Host.

    Use 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).

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

  7. Para modificar los enlaces contenidos en el HTML de la página, proporcione la regla de reescritura de URL en regex.

    Ejemplo:

    Para reemplazar una localización completa con solo el código de idioma en https://example.org/en-us/images/sample.jpg, busque /([a-z]{2})-[a-z]{2}/ y reemplácelo 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.

  8. 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 CAT Editor 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 trabajo de Adobe Experience Manager, cree una plantilla de proyecto configurada según sus necesidades:

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

Si utiliza versiones heredadas, será necesario crear y validar un servicio y un portal de solicitudes. Para validar la configuración, siga estos pasos:

  1. Abra un proyecto de traducción incompleto.

  2. Seleccione Exportar en el menú del mosaico trabajo.

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

  4. En Phrase, navegue a los portales de remitente utilizados para la integración y abra la URL indicada.

  5. Completar el formulario SP, cargar el archivo .XML, verificar el correo electrónico y enviar.

  6. Verificar 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

AEM en las instalaciones

  1. Si migra desde 6.2 o 6.3 a 6.4 o superior, elimine todas las configuraciones de servicios en la nube heredados de la herramienta admin de la interfaz de usuario clásica (/miscadmin#/etc/cloudservices/memsource-translation).

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

  2. En Herramientas, Implementación, vaya a Paquetes.

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

  4. Seleccionar Cargar paquete y cargar el archivo de instalación.

  5. Marque Forzar carga y enviar.

AEM como servicio en la nube

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

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

    <repositories>
    ...
      <repository>
        <id>project.local</id>
        <name>project</name>
        <url>file:${maven.multiModuleProjectDirectory}/repositorio</url>
      </repositorio>
    ...
    </repositories>
  2. Agregar dependencia de 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. Agregar 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>
      <configuration>
      <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. Agregue el plugin al repositorio local de maven. Ejecute 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 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=./repository/ -Dpackaging=zip
    
  5. Establezca la versión correcta del plugin 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>
    

Configurar el plugin

Se requieren dos configuraciones:

  • Indique al sistema que Phrase existe agregándolo como proveedor de servicio de traducción especificando cómo conectarse al TMS.

  • Indique a Adobe Experience Manager cuándo y cómo se debe usar Phrase configurando la integración de traducción.

    Ejemplo:

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

Agregar Phrase como proveedor de servicio de traducción

Siga estos pasos:

  1. En Herramientas, General, vaya a Explorador de configuración.

  2. Cree 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 Servicios en la nube, vaya a Servicios de traducción en la nube.

  4. Expanda el directorio conf.

  5. Cree una nueva configuración e introduzca 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 está usando 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).

    Haga clic en Conectar.

  6. Seleccionar otras opciones y cerrar la configuración.

    • Agrupar 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 Set job to completed once pre-translated y Set project to completed once all jobs are completed están habilitados al mismo tiempo en la configuración de la plantilla de proyecto de Phrase.

    • Establecer el estado del trabajo de Phrase en Delivered 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. 

    • Generar presupuestos 

      Si la generación automática de análisis está activada, se pueden generar presupuestos basados en estos análisis.

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

Configuración de la integración de traducción

Al usar el Phrase Translation Plugin 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. Usar la configuración de integración del proyecto para evitar que se incluyan activos no traducibles o materiales de referencia en los proyectos.

  1. En Herramientas, vaya a Cloud Services, haga clic en Translation Cloud Services.

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

    • Asegúrese de que Translate Component Strings y Translate Tags estén desmarcados.

    • Establecer Translate page assets en Do not translate.

    • En la pestaña Assets, establezca el flujo de trabajo de traducción en Do not translate.

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

Aplicar la integración de traducción a Sites

Configure el proveedor 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 Advanced, seleccione la configuración recién creada como la configuración de la nube.

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

Enviar contenido para traducción

Para enviar contenido (sitios, recursos) 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 Sites, navegue hasta la página, selecciónela y abra el References Panel.

  2. Haga clic en Language Copies y expanda la sección Create & Translate en la parte inferior del riel.

  3. Seleccione los idiomas meta, opcionalmente desmarque Select all sub-pages.

  4. Seleccione Create Multi-language Translation Project.

    Si hay varios idiomas meta, se creará un proyecto separado para cada idioma.

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

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

  7. Haga clic en los puntos suspensivos en el 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.

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

    Se creará un nuevo proyecto en unos minutos.

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

    • Una vez que un proveedor acepta el trabajo, 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 se elimina o se cancela.

    Consejo

    Adobe Experience Manager sondea una actualización del estado del trabajo en un horario que se configura en Configuración de la plataforma de traducción a la que se accede a través de Consola web.

    Establecer 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 extracción.

  9. En Phrase, traduzca los trabajos del proyecto y establezca su estado en Completado. Tras finalizar, 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 plugin.

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.

Varios

Personalizar asignación de idioma

AEM en las instalaciones

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

La asignación se aplica tanto al idioma fuente como al idioma meta.

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

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

  3. Crear un nodo nuevo.

  4. Usa el código de idioma de Adobe Experience Manager como Nombre (p. ej., zh), mantén Tipo: NT:unstructured.

  5. Agregar propiedad:

    • Nombre: memsourceLanguage

    • Tipo: Cadena

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

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

  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>

IDs de proyecto

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

Use los ID para mostrarlos en el entorno de AEM o en las API 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.