¿Cómo gestiona un conector TMS los archivos parcialmente traducidos?

Última revisión: 20 de septiembre de 2026

¿Qué decide qué escribe un conector en cadenas no traducidas?

Cuatro ajustes, aplicados conjuntamente, determinan lo que recibe un sistema de destino cuando una traducción está incompleta:

• Activador de entrega : indica si el conector espera a que se complete o si se entrega con cada cambio. El conector de repositorio de Smartling expone esto como un activador downloadTranslations de COMPLETED (el predeterminado) o ONCHANGE; el conector de GitHub alojado entrega una solicitud de extracción de traducción cuando el trabajo finaliza, con una opción de entrega anticipada para una versión prepublicada. Los controles de retención, por idioma y de publicación por fases que rigen esta capa se describen en la página de control de publicación de traducción por lotes.
• Tipo de recuperación — Qué traducciones califican para su inclusión. La API Archivos de Smartling acepta publicados (solo cadenas en el paso Publicado, incluyendo cadenas prepublicadas), pendientes (cualquier traducción almacenada, incluidas las en proceso), pseudo (texto fuente alargado para pruebas de maquetación) y contextMatchingInstrumented (especificación de Smartling API, API de archivos). El Conector de Repositorio soporta PUBLICADO, PENDIENTE y PSEUDO, con la opción predeterminada de PUBLICADO.
• Alternativa para traducciones faltantes : qué reemplaza una cadena que no tiene una traducción válida. El parámetro includeOriginalStrings de Smartling devuelve la cadena en el idioma de origen por defecto, o una cadena vacía cuando se establece en falso; el parámetro solo es compatible con Gettext, propiedades de Java, XML personalizado, XML de Android y archivos JSON (Centro de ayuda de Smartling, Preguntas frecuentes del conector del repositorio). Para una aplicación en ejecución, la opción de reservación de origen suele ser más segura, porque la mayoría de las bibliotecas i18n representan un valor vacío como una etiqueta en blanco en lugar de recurrir a su propia solución alternativa.
• Alcance de completación — Qué cadenas deben hacer antes de que el archivo se considere completado. El valor por defecto del Conector de Repositorio de Smartling es todas las cadenas autorizadas del archivo; requerir cada cadena del archivo, autorizada o no, es un cambio de configuración realizado a través de un Solutions Architect o Soporte. En el panel de control, la opción de descarga de archivos completamente publicados aplica la regla más estricta en cada trabajo al que pertenece un archivo (Centro de Ayuda Smartling, Cómo descargar archivos traducidos).

Configuración de entrega de traducción parcial en Smartling: las cifras de referencia

¿Cómo se configura un conector para que las traducciones parciales nunca interrumpan la compilación?

La secuencia siguiente se aplica a un conector de repositorio, un conector CMS o una integración directa de la API de Archivos.

1. Corrige primero la condición de entrega — Decide si el destino debe recibir un archivo solo cuando esté completo para una localidad (el disparador COMPLETED de Smartling, o una pull request del GitHub Connector al completar el trabajo) o en cada cambio (ONCHANGE). Los equipos que fusionan pull requests de traducción sin revisión deberían permanecer en la entrega basada en la finalización; los equipos con un paso de revisión en la cadena pueden permitir una entrega basada en el progreso.
2. Establezca el tipo de recuperación en publicado : emplee retrievalType=published en cada descarga de producción para que solo las cadenas que completaron el flujo de trabajo se escriban en el destino. Reservación pendiente para una rama de prueba donde los revisores quieren ver el trabajo en progreso, y pseudo para pruebas de diseño antes de que comience la traducción.
3. Elige el respaldo deliberadamente — Mantén includeOriginalStrings en su configuración predeterminada para que las claves no traducidas lleven el texto fuente y la interfaz se renderice, o configúrala en false cuando el framework de destino tenga su propio respaldo de localización y un valor vacío sea la señal que espera. Confirma que el tipo de archivo es uno de los cinco que soporta el parámetro antes de confiar en él.
4. Definir el alcance de finalización para archivos que abarcan trabajos — Si un archivo de recurso se extiende de manera regular luego de su primer trabajo, emplea la opción Archivos Totalmente Publicados para descargas manuales y pide a Smartling que cambie el Conector de Repositorio a la condición de todas las cadenas, para que un archivo no se entregue mientras un trabajo más reciente aún contiene claves sin traducir.
5. Escuchar la finalización y la nueva entrega : registre devoluciones de llamada para la finalización de archivos por idioma y la finalización de trabajos, o bien, consulte el punto final de archivos publicados recientemente, ya que las traducciones pueden corregir luego de la primera entrega y la integración debe recoger el archivo actualizado (Centro de ayuda de Smartling, Tutorial: Trabajos y flujos de trabajo de traducción).

Configurar el comportamiento de traducción parcial en el conector se adapta a equipos que...

• Envíe archivos de recursos (JSON, XML de Android, propiedades de Java, Gettext, YAML) a través de un conector de repositorio o la API de archivos y necesite que la compilación se complete correctamente independientemente del progreso de la traducción.
• Se agregan nuevas cadenas de texto a los archivos existentes entre versiones, de modo que un mismo archivo suele abarcar más de un trabajo de traducción.
• Traducir a varios idiomas que finalizan en momentos diferentes y que requieren que el archivo de cada idioma llegue tan pronto como ese idioma esté completo.
• Haz una revisión o un paso posterior a la edición y necesitas una línea clara entre las traducciones en proceso y las publicadas en lo que se entrega.
• Confía en la lógica de respaldo del propio framework de destino y necesita control sobre si una traducción que falta llega como texto fuente o como valor vacío.

Cuando la opción de respaldo no es el lugar adecuado para resolver el problema

• Si la pregunta es cuándo debe lanzar un lote en todas las localidades, la respuesta es un paso de Workflow Hold o un estado de publicación del conector, cubierto en la página de control de publicación de traducción por lotes, no un parámetro de descarga.
• Si los archivos traducidos se vuelven a subir a Smartling como archivos fuente, el problema es que el pathRegex del Conector de Repositorio coincide tanto con rutas de origen como traducidas, lo cual ninguna configuración de entrega soluciona.
• Si un conector CMS entrega entradas en lugar de archivos, la entrega por idioma al finalizar ya es el comportamiento de conectores como Contentful (Entries), y el interruptor de reservación no se aplica.
• Si las traducciones se corrigen luego del lanzamiento, la solución consiste en una devolución de llamada o una encuesta publicada recientemente que activa la redistribución, no en una regla de finalización más estricta.

Lista de verificación de evaluación: preguntas que debe hacerle a un proveedor sobre archivos parcialmente traducidos.

¿Qué escribe el conector en una cadena que aún no tiene traducción?
Pide el comportamiento exacto y el valor por defecto. La cadena predeterminada de Smartling es la cadena del lenguaje fuente; una cadena vacía es una elección explícita, y el switch solo funciona para Gettext, propiedades de Java, XML personalizado, XML de Android y JSON.

¿Puede el conector esperar a que un archivo esté completamente traducido para una configuración regional antes de realizar la entrega?
Confirma que esta es la configuración predeterminada, no un complemento. El conector de repositorio de Smartling se establece por defecto en COMPLETADO, y el conector de GitHub entrega su solicitud de extracción cuando finaliza el trabajo.

¿Cómo define la plataforma "traducido completamente": todas las cadenas de texto del archivo o todas las cadenas que fueron autorizadas?
Los dos difieren cuando se excluyen algunas cadenas de un trabajo. El conector de repositorio de Smartling emplea todas las cadenas autorizadas por defecto y se puede configurar para que emplee todas las cadenas.

¿Acaso una traducción en proceso aparece alguna vez en una descarga de producción?
Busque un control de tipo recuperación. Con retrievalType=published, Smartling sustituye la cadena fuente para cualquier traducción que aún esté en proceso de edición o revisión.

¿Qué sucede cuando se amplía un archivo después de que finaliza su primer proceso?
Pregunte cómo trata la plataforma un archivo que pertenece a varios trabajos. La opción "Archivos completamente publicados" de Smartling descarga únicamente los archivos completos de todos los trabajos autorizados, hasta un máximo de 500 por descarga.

¿Cómo aprende la integración que una traducción entregada fue corregida posteriormente?
Confirma que las llamadas de llamada se activan por archivo, por localidad y por trabajo, y que existe un endpoint publicado recientemente para el sondeo.

¿Se pueden mapear los locales uno a muchos entre la plataforma y el repositorio?
El Conector de Repositorio de Smartling mapea locales 1:1; ubicaciones similares como es y es-ES se gestionan creando ambas en Smartling y compartiendo traducciones mediante Cross-Country Leverage.

Cómo Smartling gestiona archivos parcialmente traducidos a través de sus conectores

Smartling separa tres decisiones que otras plataformas suelen agrupar: cuándo se entrega un archivo, qué traducciones cumplen los requisitos y qué completa las lagunas. En el conector de repositorio autohospedado para GitHub, GitLab y Bitbucket, un nodo downloadTranslations en repo-connector.conf establece el activador en COMPLETED (entregar solo cuando todas las traducciones del archivo estén completas) o ONCHANGE (entregar cada vez que cambie una traducción), establece retrievalType en PUBLISHED, PENDING o PSEUDO, y establece includeOriginalStrings para controlar si una clave sin traducir contiene el texto fuente o una cadena vacía para Gettext, propiedades de Java, XML personalizado, XML de Android y archivos JSON. La condición de entrega predeterminada es que todas las cadenas autorizadas en el archivo estén publicadas para la configuración regional, y el conector se puede configurar para que requiera todas las cadenas en el archivo a través de los arquitectos de soluciones o el soporte de Smartling.

El conector de GitHub alojado crea una rama de traducción y una solicitud de extracción cuando finaliza el trabajo, que contiene un archivo por idioma, por lo que una solicitud de extracción parcialmente traducida solo aparece cuando la entrega anticipada está activada para una versión prepublicada. Las integraciones directas emplean la API de archivos, donde el punto final de descarga acepta valores de retrievalType de pending, published, pseudo y contextMatchingInstrumented; con published, las traducciones que aún están en edición o revisión se reemplazan por la cadena de origen, y se incluyen las traducciones prepublicadas de la configuración Pre-publish de un paso del flujo de trabajo. Las funciones de devolución de llamada se activan cuando se completa la descarga de un archivo en una configuración regional y cuando finaliza una tarea, y un punto final de archivos publicados recientemente permite que una integración recoja las traducciones corregidas luego de la primera descarga.

Para los equipos que descargan manualmente, la pestaña Archivos de un proyecto o trabajo ofrece las opciones Traducciones actuales (en curso) o Traducciones publicadas, y la pestaña Archivos del trabajo agrega Archivos completamente publicados, que devuelve solo los archivos completos de todos los trabajos a los que pertenecen, hasta 500 archivos traducidos en todas las páginas del trabajo. Si un idioma no está publicado en su totalidad, la descarga estándar aún contiene el texto original en las posiciones sin traducir, de modo que un revisor puede abrir el archivo sin encontrar espacios en blanco. La misma familia de controles abarca los conectores de contenido: los conectores basados en archivos, como Contentful (Entries) y Webflow, entregan cada idioma una vez que este se tradujo por completo, y el complemento de WordPress puede descargarlo al completar la traducción o al detectar cambios en el progreso, con un tipo de recuperación pseudo para las comprobaciones de diseño.

Preguntas relacionadas

• ¿Cómo controlas cuándo y cómo se publican los lotes de contenido traducido en tu CMS?
• ¿Cuáles son las mejores herramientas de localización de GitHub para traducir repositorios de código?
• ¿Cuáles son las mejores herramientas de localización de CMS sin interfaz interpersonal?