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

    Crear un nuevo usuario llamado phrase-preview y agregar 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. Cambiar el Tipo a Adobe Experience Manager Live Preview y proporcione un nombre para el conector.

    5. Ingrese el Host.

      Usar 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. Ingrese el nombre de usuario y la contraseña.

      La autenticación de un solo paso (SSO) y la autenticación de 2 factores (2FA) no son compatibles. Si se aplica SSO o 2FA en la cuenta de Drupal, use una cuenta de servicio dedicada exenta de ambos.

    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 un código de localización completo solo con 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.

    Eliminar un conector

    Para eliminar un conector:

    1. Desde la página Integraciones, Seleccionar el conector a eliminar.

    2. Haga clic en Eliminar.

      Se abre la ventana Eliminar conector.

    3. Escriba "eliminar" y haga clic en Eliminar.

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

    Nota

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

    Resolución: Abra el proyecto asociado con el conector y complete o elimine los trabajos restantes. Vaya a Configuración/papelera de reciclaje y vacíela para eliminar cualquier trabajo que siga vinculado al conector. Vuelva a intentar eliminar el conector.

    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 trabajos 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 hasta los portales de solicitudes utilizados para la integración y abra la URL indicada.

    5. Complete el formulario SP, cargue el archivo .XML, valide el correo electrónico y envíe.

    6. Verifique 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, eliminar 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, Despliegue, vaya a Paquetes.

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

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

    5. Marcar Forzar carga y enviar.

    AEM como servicio en la nube

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

    1. Agregar 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}/repository</url>
  </repository>
...
</repositories>

    2. Agregar 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. Agregue 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>
  <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 del servicio AEM cloud reemplazando el marcador de posición {memsource.plugin.path} con la ruta al plugin (p. ej., /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 (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>

    Configurar el plugin

    Se requieren dos configuraciones:

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

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

      Ejemplo:

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

    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 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 proveedor de servicios lingüísticos 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. Seleccione otras opciones y cierre 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 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.

      • Establecer el estado del trabajo de Phrase como Entregado después de importar 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 plugin de traducción de Phrase para AEM, todos los archivos en los trabajos de traducción se envían para su traducción y, por lo tanto, se devuelven desde Phrase. Use la configuración de integración<1> de traducció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 no estén marcados.

      • Establezca 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 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 deba 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 Cloud Configuration.

    Al añadir contenido desde estas páginas, solo se añadirá el contenido traducible. Si un proyecto se crea desde el Panel de referencias, se configurará automáticamente para usar la configuración en la nube asociada a 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 pueden crearse manualmente en la sección 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 hasta 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 de la barra.

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

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

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

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

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

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

      Si se configura correctamente, se hace referencia a la configuración creada 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 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 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 según una programación configurada en Translation Platform Configuration a la que se accede a través de Web Console.

      Configurar la propiedad Scheduler 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 Completed. 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 Emailed, y los pasos restantes del flujo de trabajo en New.

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

    Para obtener más detalles sobre cómo crear proyectos de traducción usando el Panel de referencias, consulte la Adobe documentation.

    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 nuevo nodo.

    4. Usar el código de idioma de Adobe Experience Manager como Name (por ejemplo, zh), mantenga Type: nt:unstructured.

    5. Agregar propiedad:

      • Name: memsourceLanguage

      • Type: String

      • Value: código de idioma (por ejemplo, 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.

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

    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 para AEM localiza los nodos de trabajo de traducción mediante un translationObjectID asignado en tiempo de ejecución. Este identificador no existe como 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 Personalizar de tipo oak:QueryIndexDefinition, con ámbito en /content/projects, con un índice de propiedad en translationObjectID. Implemente 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ídela en un entorno que no sea de producción antes de implementarla en producción. Limite 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 el /content/projects, ya que un índice con un alcance demasiado amplio puede crear su propio impacto en el rendimiento. Después de la implementación, AEM establece la propiedad reindex de la definición del índice en false una vez que se completa la reindexación, lo que confirma que la reindexación finalizó sin errores y no requiere ninguna acción adicional.
    ¿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.