Conector de Phrase Strings (Job Sync)

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

La integración de Phrase Strings (llamada Job Sync 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 devolverlos a Strings después de traducirse. De forma predeterminada, los trabajos enviados desde Strings a TMS se importan como archivos XLIFF 2.0.

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 un trabajo. 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 locale 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 Figma pueden visualizarse en Strings como un archivo activo completo, pero no son compatibles con TMS. El editor CAT de TMS solo puede mostrar contenido traducido en un Figma marco específico en formato SVG.

Los estados de traducción de clave de Strings no son compatibles. Las claves marcadas como sin verificar en Strings antes de la importación a TMS pueden devolverse a Strings como verificadas en caso de que las traducciones de destino no hayan cambiado.

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.
La opción Segment XLIFF se ha habilitado en la configuración de importación de archivos 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 setting up the connector in TMS, habilita la opción Enclose HTML content in CDATA 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 vuelven a insertar 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 una gestión diferente por grupo de configuración regional, configure reglas de APC separadas, cada una apuntando a una plantilla de proyecto diferente.

El conector utiliza anotaciones de configuración regional de trabajo para adjuntar metadatos sobre el proyecto de Phrase TMS correspondiente a los trabajos y configuraciones regionales de trabajo de Strings. El punto final de la API de Phrase Strings para listar las anotaciones de configuración regional de 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 del mismo idioma 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 general no se puede marcar como completado. No seleccione el idioma de origen como idioma 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 Analizar mensajes ICU en la configuración de la importación de archivos XLIFF 2.0 o en las plantillas de proyecto de TMS.

Casos prácticos

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, configure 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, configure la ubicación supervisada por APC para que apunte únicamente a la ruta del proyecto y la rama, sin la subcarpeta de trabajos (por ejemplo, All projects / [project name] / [branch]). Utilice la supervisión basada en programación en lugar de la supervisión basada en webhooks, ya que la sincronización a nivel de proyecto no inicia un trabajo de Strings y el evento de webhook jobs:start nunca 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 Crear un nuevo proyecto cada vez 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 actualizaciones meta realizadas en la entidad remota se guardan automáticamente en la TM 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:start para las sincronizaciones a nivel de trabajo.

Página de sincronizaciones de trabajos

La página Sincronizaciones de trabajos ofrece una vista centralizada de todas las configuraciones de sincronización de trabajos (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 pertinente.

Desde la página Sincronizaciones de trabajos, los usuarios con rol de Administrador y Gestor de proyectos en Strings pueden configurar nuevas sincronizaciones de trabajos, editar las existentes (incluido su estado activo/inactivo) o eliminarlas.

Las sincronizaciones de trabajos existentes se pueden editar o eliminar utilizando las opciones pertinentes en el menú Más . Todos los cambios se sincronizan entre Strings y TMS. La eliminación de una sincronización de trabajos elimina el APC correspondiente en TMS.

La página Sincronizaciones de trabajos es accesible tanto desde el menú de navegación Integraciones como desde el de Trabajos a la izquierda.

Configurar sincronizaciones de trabajos en Strings

Nota

Si se definen campos personalizados obligatorios en TMS, no se admite la configuración de una sincronización de trabajos desde Strings.

Para configurar una nueva sincronización de trabajos entre Strings y TMS con una configuración básica, sigue estos pasos en la interfaz de usuario de Strings:

En la página Integrations, selecciona Configure junto a la integración Job Sync.

Se muestra la página Job Syncs.
Haz clic en + New Job Sync.

Se muestra la ventana Create new Job Sync.
Proporciona un Sync Name y selecciona los proyectos de Strings a conectar a TMS desde el menú desplegable Assigned Strings projects.

Solo se pueden incluir proyectos con las mismas combinaciones de idiomas.
Opcionalmente, selecciona el TMS project template a usar. La plantilla de proyecto de TMS seleccionada debe coincidir con el conjunto de idiomas definidos 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 Default, se crea automáticamente una plantilla de proyecto de TMS basada en los proyectos de Strings seleccionados.
Selecciona el Type de proyecto que deseas crear en TMS.
- Proyecto continuo
  
  Opción predeterminada.
- Proyecto nuevo
  
  Se crea un nuevo proyecto de TMS cada vez que se detectan cambios en los trabajos de Strings.
En la sección Export back to Strings, especifica los ajustes de exportación de Strings para controlar cómo se exportan las traducciones de TMS de vuelta a Strings.
- Sobrescribir traducciones existentes
  
  Actualiza las traducciones de destino existentes en Strings.
- Marcó el trabajo como completado
  
  Marca automáticamente el trabajo como completado en Strings.
- Verificar las traducciones sin cambios en Strings
  
  Las claves marcadas como unverified se verificarán automáticamente en Strings en caso de que las traducciones de destino no hayan cambiado.
Si es necesario, haz clic en Advanced options para mostrar opciones de exportación adicionales.
- Marcó la localización como completada
  
  Marca una configuración regional específica como completada una vez que sus traducciones se sincronizan de vuelta a Strings.
- Crear claves nuevas y actualizar las existentes
  
  Asegura que las nuevas claves de TMS se creen en Strings y que las existentes se actualicen.
- Solo aplicar traducción si la fuente coincide con la versión guardada
  
  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 trabajos se añade a la lista TMS Job Syncs con estado inactivo. Utiliza el interruptor en la columna Active 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.

Configuración de Phrase 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 Connectors antes de crear uno manualmente. El conector creado automáticamente se autentica en el servidor utilizando la identidad de inicio de sesión, no un token de acceso introducido manualmente.

El conector muestra el estado Pendiente mientras completa su sincronización inicial después de la creación, luego cambia a Activo. El estado Pendiente 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 muestra Pendiente, no puede utilizarse como origen para la creación de trabajos en Phrase TMS. Espera a que el estado cambie a Activo antes de crear trabajos con ese conector.

En la página Configuración , desplázate hacia abajo hasta la sección Integraciones.
Haz clic en Conectores.

Se abrirá la página Conectores.
Haz clic en Nuevo conector.

Se abrirá la página Crear conector.
Cambia el Tipo a Phrase Strings 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 Probar conexión.
Selecciona los elementos para importar a TMS.

Si no se importan las claves de destino, el archivo XLIFF 2.0 puede segmentarse aún más al seleccionar Segmentar XLIFF en la Configuración de importación de archivos para archivos XLIFF 2.0.
- Habilita o deshabilita las opciones de importación avanzada según sea necesario:
  - Aplicar el idioma de origen del proyecto TMS al importar
    
    El idioma de origen del proyecto de TMS se aplica independientemente del idioma predeterminado en el proyecto de Strings.
  - Crear un trabajo TMS para cada lengua
    
    Habilita esta opción para evitar la creación de trabajos duplicados en TMS para localizaciones que 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 complete el trabajo original. Recomendado para un mayor control en trabajos con varios idiomas.
  - Envolver contenido HTML en CDATA
    
    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:
  - Sobrescribir traducciones
    
    Deshabilita para evitar que las traducciones existentes se actualicen con el contenido del archivo.
  - Crear o actualizar claves
    
    Deshabilita para evitar la creación de nuevas claves y las actualizaciones de las claves existentes.
  - Aplicar traducción solo con concordancia de fuente
    
    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.
  - Verificar solo si la traducción no ha cambiado
    
    Las claves marcadas como sin verificar 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 el TMS se marca como verificada en Strings, independientemente de si el texto se editó o simplemente se devolvió sin cambios. Solo se excluyen y permanecen sin verificar las claves cuyo texto de origen cambió en Strings mientras el trabajo estaba abierto.
  - Marcar idioma como completado
    
    Marca una configuración regional específica como completada una vez que sus traducciones se sincronizan de vuelta.
  - Marcó el trabajo como completado
    
    Si se selecciona, solo cuando se cargue la última configuración regional se marcará el trabajo como completado.
Si se especifica, selecciona una carpeta predeterminada (solo posible después de guardar).
Aparece laasignación de idiomas y se puede personalizar si es necesario. Asegúrate de que cada configuración regional de Strings tenga solo una entrada de asignación a 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 muestra cinco proyectos a la vez y organiza los proyectos alfabéticamente, primero de la A a la Z (en mayúsculas) y luego de la a a la z (en minúsculas).
Haz clic en Guardar.

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

Eliminar un conector

Para eliminar un conector:

Desde la página Integrations, selecciona el conector que deseas eliminar.
Haz clic en Eliminar.

Se abre la ventana Eliminar conector.
Escribe "delete" y haz clic en Eliminar.

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

Nota

No se puede eliminar un conector 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 Abre el proyecto asociado con el conector y completa o elimina los trabajos restantes. Ve a Configuración/Papelera de reciclaje y vacíala para eliminar cualquier trabajo que siga vinculado al conector. Vuelve a intentar eliminar el conector.

Compatible con la integración:

Plantillas del proyecto de TMS
Flujos de trabajo de TMS
Briefing del trabajo (no aplicable cuando se utiliza la sincronización a nivel de proyecto)
Fecha de entrega del trabajo (no aplicable cuando se utiliza 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 Nota de contexto de los editores CAT del TMS:
- Habilita la opción Permitir la carga de contenido externo en el editor CAT de Phrase en la sección Acceso y seguridad de la configuración del proyecto de TMS.
- Selecciona el formato de texto enriquecido Rich en el panel Nota de contexto.
Personalizar metadatos en formatos de archivo compatibles:
- .XLSX
- .CSV
- .XLIFF 2.0

Supervisión de actualizaciones de meta realizadas en Strings mediante APC

Para supervisar las actualizaciones meta realizadas en Strings mediante APC, sigue estos pasos:

Al configurar APC, selecciona Crear un nuevo proyecto cada vez.

Esto permite la supervisión del repositorio en línea en busca de actualizaciones de meta realizadas en Strings.
En la sección Automatizaciones de la configuración de APC, las actualizaciones meta realizadas en la entidad remota se guardan automáticamente en la TM.

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 haberla incluido en un trabajo no afecta a un trabajo de Phrase TMS que se creó mediante una importación manual única. 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 de proyecto continuo, 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 de crear un proyecto nuevo cada vez, 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.

Solución de problemas de Job Sync

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 `NMTOKEN` en trabajos de TMS	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: Ignorar los segmentos Eliminar las claves del trabajo de Strings y volver a importar la fuente del repositorio en línea
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: Añadir una nueva clave al trabajo o actualiza una clave existente del trabajo Cambiar la fecha de entrega del trabajo en Strings
	Error `429 Too many requests` (límite de API de Strings)	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 añadió al trabajo de Strings	Añada la clave al trabajo de Strings y vuelva a importar el trabajo desde el repositorio en línea en TMS
Aparece el error \"No se pudo autenticar\" al intentar importar/exportar trabajos.	Token de acceso caducado o revocado en el conector \"creado por 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 volver a importarlo a través de APC o manualmente, aunque no aparece como completado.	El trabajo ya se importó a un proyecto de TMS que posteriormente se movió a la papelera de reciclaje sin completarse ni eliminarse. Debido a que el proyecto técnicamente sigue en curso, el trabajo no se libera para volver a importarlo.	Comprueba las Anotaciones del trabajo junto a su configuración regional en Strings para verificar si ya se ha importado a TMS antes de seguir solucionando problemas. Si el proyecto vinculado se encuentra en la papelera de reciclaje, restáuralo y sigue trabajando en él directamente, o, si no lo necesitas, cancela los trabajos y el proyecto, o elimínalo de forma permanente a través de la API utilizando el parámetro `purge=true` para que APC ya no lo considere una versión activa.
La sincronización de trabajos no se guarda y aparece el error \"`Los locales no son compatibles con Phrase TMS: x`\", a pesar de que el conector de TMS tiene configurada una asignación de locales personalizada.	Job Sync valida los locales de destino en el proyecto de Strings directamente con la lista de locales admitidos de forma nativa por TMS al momento de guardar. Esta validación no tiene en cuenta las asignaciones de locales de conectores personalizados.	Para un proyecto de Strings con un locale de destino no admitido de forma nativa por TMS, utiliza el conector de Strings directamente en TMS en lugar de hacerlo desde Strings y configura la asignación de locales 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 son entregados. Esto fuerza a los trabajos a un estado de 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, establece Marcar proyecto como 'completado' una vez que todos los trabajos estén "entregados en todos sus pasos de flujo de trabajo" en lugar de completados en todos sus pasos de flujo de trabajo. Para los trabajos creados manualmente, exporta manualmente el trabajo de vuelta a Strings y cambia manualmente el estado del trabajo a entregado, ya que las exportaciones manuales no actualizan el estado del trabajo automáticamente. Una vez que se han marcado todos los trabajos del proyecto como entregados, el proyecto se marca automáticamente como completado.