La integración de Phrase Strings (llamada en la interfaz de Strings) conecta Phrase TMS y Phrase Strings. La integración admite la sincronización tanto a nivel de trabajo como a nivel de proyecto.
-
Sincronización de trabajos
Los trabajos creados e iniciados en Strings con el estado En proceso se pueden importar a TMS para su traducción y devolverse a Strings después de traducirse.
Recomendado para flujos de trabajo basados en lotes con control granular.
-
Sincronización a nivel de proyecto
Todas las claves de un proyecto de Strings seleccionado se transfieren a TMS, sin necesidad de crear trabajos. Las claves recién añadidas o actualizadas pasan a estar disponibles para la sincronización automáticamente.
Recomendado para flujos de trabajo de localización continua.
Requisitos previos
-
Acceso a las aplicaciones TMS y Strings
-
Los códigos de idioma utilizados en el proyecto de TMS deben coincidir con los códigos de configuración regional del trabajo de Strings.
-
El idioma predeterminado del proyecto de Strings debe ser el mismo que el idioma de origen definido en el proyecto de TMS.
Importante
Los archivos de Figma se pueden mostrar íntegramente en Strings y en tiempo real, pero esta función no es compatible con TMS. El editor CAT de TMS solo puede mostrar el contenido traducido de un marco específico de Figma en formato SVG.
De forma predeterminada, el contenido enviado desde Strings a TMS se importa como archivos XLIFF 2.0. Al utilizar APC, el en la configuración de importación de archivos de la plantilla de proyecto de TMS debe establecerse en o .
Los estados de traducción de las claves de Strings no son compatibles. La sincronización de trabajos envía el texto de destino almacenado actualmente en Strings a TMS, independientemente de si la clave está verificada o no. Las claves marcadas como en Strings antes de la importación a TMS pueden devolverse a Strings como en caso de que las traducciones de destino no hayan cambiado.
La sincronización de trabajos no aplica la configuración del proyecto de Strings . La sustitución por traducciones de reserva no se produce en ninguna dirección entre Strings y TMS, por lo que el texto de la configuración regional de reserva no reemplaza las traducciones no verificadas.
El número de segmentos creados en TMS después de importar un trabajo de Strings puede ser diferente al número original de claves en los siguientes casos:
-
Las claves se marcan como excluidas en Strings. Las claves excluidas no se importan.
-
Se ha habilitado la opción Segmentar XLIFF en la configuración de importación de archivos para XLIFF 2.0 al crear el trabajo en TMS. En este caso, el número de segmentos puede ser mayor que el número de claves en Strings.
Las claves de Strings pueden contener entidades HTML. Al configurar el conector en TMS (), habilita la opción para preservar las entidades HTML en lugar de mostrar los caracteres correspondientes en TMS.
Los espacios iniciales y finales presentes en el texto de origen de una clave de Strings no se muestran en el editor CAT de TMS. Estos espacios se conservan en el esqueleto y se reinsertan tanto en el origen como en el destino cuando el trabajo se sincroniza de nuevo con Strings. Esto puede afectar a las validaciones de límite de caracteres configuradas en Strings, ya que el recuento de espacios no se refleja en el editor de TMS durante la traducción.
Con el conector se pueden monitorizar varios proyectos y archivos en APC. Cada proyecto requiere una monitorización individual dentro de un único APC.
Cuando APC procesa un activador de sincronización de trabajos, crea un trabajo de TMS por cada configuración regional de Strings. El orden de importación de estos trabajos no está garantizado y no se puede configurar a través de la plantilla de proyecto asignada a la regla de APC. No se aplica ningún mecanismo de ordenación en ninguna etapa de este proceso. Para aplicar un tratamiento diferente a cada grupo de configuraciones regionales, configura reglas de APC independientes, cada una asociada a una plantilla de proyecto diferente.
El conector utiliza anotaciones de las configuraciones regionales de los trabajos para adjuntar metadatos sobre el proyecto correspondiente de Phrase TMS a los trabajos de Strings y a las configuraciones regionales de esos trabajos. El punto final de la API de Phrase Strings para listar las anotaciones de configuración regional del trabajo recupera estos metadatos. El punto final para listar las configuraciones regionales de destino del trabajo también incluye estos metadatos cuando el parámetro include_annotations se establece en true. Los trabajos anotados contienen campos como tms_project_id y tms_in_progress, que permiten el seguimiento del estado de un trabajo de Strings en su proyecto de Phrase TMS vinculado.
TMS no admite el uso de la misma configuración regional como idioma de origen y de destino en un proyecto. Por ejemplo, si un trabajo de Strings utiliza en-US como idioma de origen y de destino, el destino en-US no se puede importar a TMS y el trabajo en su conjunto no se puede marcar como completado. No selecciones la configuración regional de origen como configuración regional de destino al crear trabajos en Strings que se sincronizarán con TMS.
Mensajes ICU y formas plurales CLDR
Al enviar trabajos de Strings con mensajes ICU o formas plurales a TMS para su traducción, habilita la opción en la configuración de la importación de archivos XLIFF 2.0 o en las plantillas de proyecto de TMS.
Hay varios casos prácticos del conector:
-
Los project managers de TMS pueden añadir archivos directamente a proyectos de TMS desde un repositorio en línea.
-
Configuración del portal del remitente de Phrase TMS para permitir a los remitentes añadir archivos a las solicitudes directamente desde Phrase Strings.
-
Uso de la creación automatizada de proyectos de TMS para que se creen nuevos proyectos automáticamente cuando se detecte un cambio en la última fecha de modificación de los archivos o carpetas supervisados.
-
Para la sincronización a nivel de trabajo, configura la ubicación supervisada por APC para que apunte a la subcarpeta de trabajos del proyecto (por ejemplo,
All projects / [project name] / [branch] / jobs). -
Para la sincronización a nivel de proyecto, configura la ubicación supervisada por APC para que apunte solo a la ruta del proyecto y la rama, sin la subcarpeta de trabajos (por ejemplo,
All projects / [project name] / [branch]). Utiliza la supervisión basada en programación en lugar de la basada en webhooks, ya que la sincronización a nivel de proyecto no inicia un trabajo de Strings y el evento de webhookjobs:startnunca se activa. -
Para las sincronizaciones de trabajo, APC se activa con las siguientes actualizaciones de trabajo:
-
Claves añadidas recientemente o cambios en las claves existentes
-
Fecha de entrega del trabajo modificado en Strings
Nota
La reapertura de trabajos no cuenta como una actualización para APC.
-
-
Para las sincronizaciones a nivel de proyecto, APC se activa con:
-
Claves recién añadidas
-
Cambios en claves existentes
-
-
Si se selecciona al configurar APC, en el repositorio remoto en línea se pueden supervisar también las actualizaciones de meta y no solo las de fuente
Si se decide supervisar las actualizaciones de meta, cualquier cambio realizado en la copia de meta en el repositorio en línea actualizará automáticamente la memoria de traducción en Phrase TMS
-
Si las seleccionada, los cambios de texto clave en el idioma meta de Strings se actualizan automáticamente en las memorias de traducción de TMS utilizadas en el proyecto de APC pertinente.
-
-
El conector API de TMS puede utilizarse para automatizar pasos que de otro modo se realizarían manualmente a través de la interfaz de usuario. Se pueden usar webhookspara notificar de determinados acontecimientos (por ejemplo, el cambio de estado de un trabajo) a sistemas de terceros. Los webhooks se pueden activar para el evento
jobs:startpara sincronizaciones a nivel de trabajo.
La página proporciona una vista centralizada de todas las configuraciones de sincronización de trabajo (APC) que utilizan el conector de Phrase Strings. Incluye tanto las sincronizaciones creadas directamente en Strings como las configuradas en TMS, con la información relevante.
Desde la página , los usuarios Administrador y Gestor de proyectos en Strings pueden configurar nuevas sincronizaciones de trabajo, editar las existentes (incluido su estado activo/inactivo) o eliminarlas.
Las sincronizaciones de trabajo existentes se pueden editar o eliminar utilizando las opciones correspondientes en el menú . Todos los cambios se sincronizan entre Strings y TMS. Eliminar una sincronización de trabajo elimina el APC correspondiente en TMS.
Se puede acceder a la página desde los menús de navegación de la izquierda y .
Nota
Si se definen campos personalizados obligatorios en TMS, no se admite la configuración de una sincronización de trabajo desde Strings.
Para configurar una nueva sincronización de trabajo entre Strings y TMS con una configuración básica, sigue estos pasos en la interfaz de usuario de Strings:
-
En la página , selecciona Configurar junto a la integración .
Se muestra la página .
-
Haz clic en + Nueva sincronización de trabajo.
Se muestra la ventana .
-
Proporciona un y selecciona en el menú desplegable los proyectos de Strings que quieres conectar a TMS.
Solo se pueden incluir proyectos con las mismas combinaciones de idiomas.
-
Si lo deseas, selecciona la que quieres utilizar. La plantilla de proyecto de TMS seleccionada debe coincidir con el conjunto de idiomas definido en los proyectos de Strings asignados.
Los trabajos sincronizados se añadirán al proyecto de TMS creado a partir de la plantilla seleccionada.
-
Si se selecciona , se crea automáticamente una plantilla de proyecto de TMS basada en los proyectos de Strings seleccionados.
-
-
Selecciona el de proyecto que quieres crear en TMS.
-
Opción predeterminada.
-
Se crea un nuevo proyecto de TMS cada vez que se detectan cambios en los trabajos de Strings.
-
-
En la sección , especifica los ajustes de exportación de Strings para controlar cómo se exportan las traducciones de TMS a Strings.
-
Actualiza las traducciones de destino existentes en Strings.
-
Marca automáticamente el trabajo como completado en Strings.
-
Las claves marcadas como sin verificar se verificarán automáticamente en Strings en caso de que las traducciones de destino no hayan cambiado.
-
-
Si es necesario, haz clic en Opciones avanzadas para mostrar opciones de exportación adicionales.
-
Marca una configuración regional específica como completada una vez que sus traducciones se sincronizan de nuevo con Strings.
-
Asegura que las nuevas claves de TMS se creen en Strings y que las existentes se actualicen.
-
Evita sobrescribir las traducciones si el texto de origen ha cambiado en Strings desde la exportación.
-
-
Haz clic en Guardar.
La nueva configuración de sincronización de trabajo se añade a la lista con estado inactivo. Usa el interruptor de la columna para habilitar la sincronización de trabajos.
Consejo
Para configuraciones más avanzadas, configura el conector utilizando los ajustes de Phrase TMS.
Siempre que se utilice una asignación personalizada, si es necesario realizar algún cambio, debe aplicarse al conector en TMS.
La creación del conector de Strings en Phrase TMS no crea automáticamente APC para la importación/exportación automatizada de trabajos. El APC debe configurarse por separado en TMS.
Algunas organizaciones ya tienen un conector de Phrase Strings creado automáticamente, utilizando la identidad de la plataforma Phrase de la organización. Comprueba la lista de conectores en la página antes de crear uno manualmente. El conector creado automáticamente se autentica en el lado del servidor utilizando la identidad con la que se inició sesión, no un token de acceso introducido manualmente.
El conector muestra el estado mientras completa su sincronización inicial tras la creación y luego cambia a . El estado también se activa siempre que se realiza algún cambio en la configuración del conector o cuando se guarda la página de configuración del conector, incluso sin cambios significativos. Mientras un conector muestre , no puede utilizarse como origen para la creación de trabajos en Phrase TMS. Espera a que el estado cambie a antes de crear trabajos con ese conector.
-
En la página Configuración
, baja hasta la sección .
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
Cambia el Tipo a y proporciona un nombre para el conector.
-
Introduce el ID de cuenta y el token de acceso obtenidos de Strings.
-
Haz clic en Conexión de prueba.
-
Si tiene éxito, aparecerá una pequeña marca de verificación junto al botón de .
-
-
Selecciona los elementos que importar a TMS.
Si no se importan las claves de destino, el archivo XLIFF 2.0 puede segmentarse aún más si se selecciona Segmentar XLIFF en la para archivos XLIFF 2.0.
-
Habilita o deshabilita las opciones de importación avanzada según sea necesario:
-
El idioma de origen del proyecto de TMS se aplica independientemente del idioma predeterminado en el proyecto de Strings.
-
Habilita esta opción para evitar la creación de trabajos de TMS duplicados para configuraciones regionales cuyos trabajos ya están en curso. Cuando está habilitado, los cambios en las claves que ya forman parte de un trabajo activo de TMS no se vuelven a importar hasta que se completa el trabajo original. Recomendado para un mayor control en trabajos con varios idiomas.
-
-
La opción garantiza que las entidades HTML estén envueltas en CDATA que se conservarán durante la transferencia entre Strings y TMS.
-
La opción permite importar contenido combinando sintaxis ICU y elementos HTML en línea.
-
-
-
-
Selecciona un modo de exportación.
-
Habilita o deshabilita las siguientes opciones de exportación según sea necesario:
-
Deshabilita esta opción para evitar que las traducciones existentes se actualicen con el contenido del archivo.
-
Deshabilita esta opción para evitar que se creen nuevas claves y se actualicen las existentes.
-
Las traducciones que no se alinean con el contenido de origen más reciente se excluyen durante la sincronización. Esto ayuda a mantener la coherencia entre el texto de origen y las traducciones, evitando traducciones obsoletas o incorrectas.
-
Las claves marcadas como se verificarán automáticamente en Strings en caso de que las traducciones de destino no hayan cambiado. Cuando está habilitado, cada traducción devuelta desde TMS se marca como en Strings, independientemente de si el texto se editó o simplemente se devolvió sin cambios. Solo se excluyen y permanecen las claves cuyo texto de origen cambió en Strings mientras el trabajo estaba abierto.
-
Marca una configuración regional específica como completada una vez que sus traducciones se vuelven a sincronizar.
-
Si se selecciona esta opción, el trabajo solo se marcará como completado cuando se cargue la última configuración regional.
-
-
-
Si se especifica, selecciona una carpeta predeterminada (solo posible después de guardar).
-
Aparece la y se puede personalizar si es necesario. Asegúrate de que cada configuración regional de Strings tenga una sola entrada que la asocie con una única configuración regional de TMS en la configuración del conector. Los cambios en la asignación de idiomas no afectarán a los trabajos existentes.
La lista se pagina de cinco en cinco proyectos y los proyectos se ordenan alfabéticamente; primero de la A a la Z (mayúsculas) y luego de la a a la z (minúsculas).
-
Haz clic en Guardar.
El conector se añade a la lista de la página .
Compatible con la integración:
-
Plantillas del proyecto de TMS
-
Flujos de trabajo de TMS
-
Instrucciones del trabajo (no aplicable al usar la sincronización a nivel de proyecto)
-
Fecha de entrega del trabajo (no aplicable al usar la sincronización a nivel de proyecto)
La fecha límite establecida en Strings actualizará la fecha límite del proyecto en TMS. Si hay varios plazos diferentes, se aplicará el más lejano en el proyecto de TMS.
Transferencia de Strings a TMS como referencia del proyecto:
-
Nombres de clave
Transferidos desde Strings y mostrados como clave de contexto en el panel Nota de contexto de los editores CAT de TMS.
-
Descripciones clave
Transferidas desde Strings y mostradas como nota de contexto en el panel Nota de contexto de los editores CAT de TMS.
-
Longitud máxima de caracteres de las claves
Transferida desde Strings y mostrada en el panel Nota de contexto de los editores CAT de TMS.
-
Capturas de pantalla
Para mostrar capturas de pantalla de Strings en el panel de los editores CAT de TMS:
-
Habilita la opción en la sección Acceso y seguridad de la configuración del proyecto de TMS.
-
Selecciona el formato de texto en el panel .
-
-
Personalizar metadatos en formatos de archivo compatibles:
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
Para supervisar las actualizaciones meta realizadas en Strings mediante APC, sigue estos pasos:
-
Al configurar APC, selecciona .
Esto permite la supervisión del repositorio en línea en busca de actualizaciones de meta realizadas en Strings.
-
En la sección de la configuración de APC, las
Los cambios realizados en el contenido del idioma meta en Strings se guardarán automáticamente en la memoria de traducción de Phrase TMS cuando se active la monitorización de APC.
Es posible sobrescribir las actualizaciones de la memoria de traducción modificando los segmentos meta en el editor de Phrase TMS. Estas actualizaciones se exportarán de vuelta a Strings cuando se complete el trabajo de Phrase TMS.
Comportamiento de eliminación de claves con APC
Eliminar una clave en Strings después de que se haya incluido en un trabajo no afecta a un trabajo de Phrase TMS que se creó mediante una importación manual puntual. Ese trabajo permanece sin cambios hasta que se vuelve a importar manualmente.
Cuando la supervisión de APC está activa, Phrase compara un hash de contenido en cada sondeo o activación de webhook y trata cualquier cambio, incluida la eliminación de una clave, como una actualización que activa una resincronización.
-
En el modo , la resincronización actualiza el proyecto o trabajo de Phrase TMS existente para que coincida con el contenido actual en Strings, por lo que el contenido de la clave eliminada se elimina de ese trabajo.
-
En el modo , la resincronización crea una nueva versión del trabajo de Phrase TMS que refleja el contenido posterior a la eliminación, mientras que las versiones de trabajo creadas anteriormente permanecen sin cambios.
La siguiente tabla describe los problemas comunes que los usuarios pueden encontrar al utilizar la integración de Strings. Proporciona posibles causas y soluciones para la solución de problemas.
|
Problema |
Causas |
Solución |
|---|---|---|
|
Mensaje de aviso relacionado con |
Los nombres clave contienen caracteres no válidos (p. ej., espacios) |
Los usuarios aún pueden gestionado el contenido de la traducción y exportarlo a Strings a pesar del mensaje de aviso. |
|
Las claves de TMS están vacías |
El trabajo contiene claves sin texto fuente en el idioma fuente |
O bien:
|
|
APC no crea proyectos ni procesa nuevos trabajos |
Desajuste de códigos de idioma |
Asegúrese de que los códigos de idioma en Strings coincidan con los del proyecto en TMS. Cuando APC se establece como un proyecto continuo, cualquier cambio realizado en la plantilla del proyecto después de crear el proyecto no se aplica a los proyectos existentes. Por lo tanto, los cambios deben realizarse directamente en los proyectos continuos. |
|
APC considera el trabajo/la localización como procesados |
Si se modifica una plantilla de proyecto/configuración APC después de iniciar el trabajo, se puede considerar como procesada en el historial de APC. Por lo tanto, puede ser necesario actualizar el trabajo para prepararlo para la siguiente iteración. O bien:
|
|
|
Error |
Reduce el número de APC y disminuye la frecuencia de monitorización. |
|
|
La clave existente en el proyecto de Strings falta en el trabajo de TMS |
La clave específica no se agregó al trabajo de Strings |
Añade la clave al trabajo de Strings y vuelve a importar el trabajo desde el repositorio en línea en TMS |
|
El error "No se pudo autenticar" aparece al intentar importar/exportar trabajos. |
Token de acceso caducado o revocado en el conector «created by Phrase Strings» creado automáticamente. |
Crea un nuevo conector de Phrase Strings en TMS, vuelve a vincular los APC existentes al nuevo conector y activa el monitor. |
|
No se puede encontrar el trabajo de Strings para importarlo o reimportarlo a través de APC o manualmente, aunque no aparezca como completado. |
El trabajo ya se importó a un proyecto de TMS que posteriormente se movió a la papelera de reciclaje sin haberse completado ni purgado. Debido a que el proyecto técnicamente sigue en curso, el trabajo no se libera para su reimportación. |
Comprueba las del trabajo junto a su configuración regional en Strings para verificar si ya se ha importado a TMS antes de seguir investigando el problema. Si el proyecto vinculado está en la papelera de reciclaje, restáuralo y sigue trabajando en él directamente. Si ya no lo necesitas, cancela los trabajos y el proyecto, o elimina el proyecto de forma permanente mediante la API con el parámetro |
|
La sincronización de trabajos no se guarda y aparece el error " |
La sincronización de trabajos valida las configuraciones regionales de destino en el proyecto de Strings directamente con la lista de configuraciones regionales admitidas de forma nativa por TMS en el momento de guardar. Esta validación no tiene en cuenta las asignaciones personalizadas de configuración regional del conector. |
Si un proyecto de Strings tiene una configuración regional de destino que TMS no admite de forma nativa, usa el conector de Strings directamente en TMS en lugar de hacerlo desde Strings y configura una asignación de idiomas personalizada. |
|
Las traducciones no se exportan de vuelta a Strings aunque los trabajos muestren un estado de entregado en TMS. |
El proyecto o la plantilla tiene una configuración de automatización del estado del proyecto que marca el proyecto (y sus trabajos) como completado/entregado una vez que todos los trabajos están pretraducidos, en lugar de una vez que se entregan. Esto fuerza a que los trabajos pasen al estado entregado sin ejecutar el paso de exportación a Strings, por lo que el servicio de automatización nunca programa la exportación y no se envían traducciones de vuelta a Strings. |
En la configuración de automatización del estado del proyecto de la plantilla del proyecto, establece en lugar de . Para los trabajos creados manualmente, exporta el trabajo a Strings y cambia manualmente su estado a entregado, ya que las exportaciones manuales no actualizan el estado del trabajo automáticamente. Una vez que todos los trabajos del proyecto tengan el estado entregado, el proyecto se marcará automáticamente como completado. |