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

Última reseña: 20 de septiembre de 2026

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

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

• Activador de entrega: si el conector espera a que se termine o entregue con cada cambio. El conector de repositorios de Smartling lo expone como un activador de DownloadTranslations de COMPLETED (el predeterminado) o ONCHANGE; el conector GitHub alojado envía una solicitud de extracción de traducción cuando se completa el trabajo, con una opción de entrega anticipada para un pase prepublicado. Los controles de retención, por configuración regional y de publicación por etapas que rigen esta capa aparecen en la página de control de publicación de la traducción por lotes.
• Tipo de recuperación: qué traducciones cumplen los requisitos para su inclusión. La API Files de Smartling acepta las cadenas publicadas (solo las cadenas de la etapa Publicado, incluidas las prepublicadas), las pendientes (cualquier traducción guardada, incluidas las que están en curso), las pseudo( el texto fuente se alarga para las pruebas de diseño) y ContextMatchingInstrumented (especificación de la API de Smartling, API de archivos). El conector de repositorios admite PUBLICADO, PENDIENTE y PSEUDO, y por defecto es PUBLICADO.
• Alternativa para traducciones faltantes: qué sustituye a una cadena que no tiene ninguna traducción válida. El parámetro IncludeOriginalStrings de Smartling devuelve la cadena del idioma de origen por defecto, o una cadena vacía si se establece en falso; el parámetro solo es compatible con Gettext, propiedades de Java, archivos XML personalizados, XML de Android y JSON (Centro de ayuda de Smartling, preguntas frecuentes sobre Repository Connector). Para una aplicación en ejecución, la alternativa de origen suele ser más segura, porque la mayoría de las bibliotecas i18n muestran un valor vacío como una etiqueta en blanco en lugar de recurrir por sí mismas.
• Alcance de finalización: qué cadenas se deben escribir antes de que el archivo se considere completo. El conector de repositorio de Smartling por defecto son todas las cadenas autorizadas del archivo; cada cadena del archivo requerida, autorizada o no, es un cambio de configuración realizado a través de un arquitecto de soluciones o de soporte. En el panel, la opción de descarga de archivos totalmente publicados aplica una regla más estricta en todos los trabajos a los que pertenezca un archivo (Centro de ayuda de Smartling, Cómo descargar los archivos traducidos).

Configuración de entrega de traducciones parciales en Smartling: las cifras de referencia

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

La siguiente secuencia se aplica a un conector de repositorios, a un conector de CMS o a una integración directa de Files API.

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 permitirse una entrega basada en el progreso.
2. Defina el tipo de recuperación como publicado: utilice retrievalType=Published en cada descarga de producción para que solo las cadenas que borren el flujo de trabajo se escriban en el destino. Reserva pendiente para una sucursal provisional en la que los revisores quieren ver el trabajo en curso y seudo para las 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 regularmente después de su primer trabajo, utiliza 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. Escucha para la finalización y reentrega — Registra las llamadas de retorno para completar archivos por localidad y trabajo, o consulta el endpoint de archivos publicados recientemente, porque las traducciones pueden corregirse tras la primera entrega y la integración debe recoger el archivo actualizado (Centro de Ayuda Smartling, Tutorial: Trabajos y Flujos de Trabajo de Traducción).

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

• Envía los archivos de recursos (JSON, XML de Android, propiedades de Java, Gettext, YAML) a través de un conector de repositorios o la API de archivos y necesita que la compilación se apruebe independientemente del progreso de la traducción.
• Añada nuevas cadenas a los archivos existentes entre versiones, de modo que un solo archivo abarque habitualmente más de un trabajo de traducción.
• Traduce a varias localizaciones que terminan en diferentes momentos y quieres que el archivo de cada localidad llegue tan pronto como esa ubicación esté completa.
• Haga una revisión o postedición y necesite una línea clara entre las traducciones en curso 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 configuración alternativa no es el lugar correcto para resolver el problema

• Si la pregunta es cuándo debe lanzarse 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 la ruta del conector del repositorio coincide con las rutas de origen y traducidas, lo que no corrige ninguna configuración de entrega.
• Si un conector CMS entrega entradas en lugar de archivos, la entrega por configuración regional al finalizar ya es el comportamiento de conectores como Contentful (entradas), y la opción alternativa no se aplica.
• Si las traducciones se corrigen tras su publicación, la solución es una llamada o una encuesta publicada recientemente que activa la devolución, no una regla de finalización más estricta.

Lista de evaluación: preguntas para hacerle a un proveedor sobre los archivos parcialmente traducidos

¿Qué escribe el conector en una cadena que aún no tiene traducción?
Pregunte por el comportamiento exacto y el predeterminado. El valor predeterminado de Smartling es la cadena del idioma de origen; una cadena vacía es una opción explícita y el cambio solo funciona para Gettext, las propiedades de Java, el XML personalizado, el XML de Android y JSON.

¿Puede el conector esperar a que se entregue hasta que el archivo esté completamente traducido para una configuración regional?
Confirme que es la opción por defecto, no un complemento. El conector de repositorios de Smartling tiene por defecto el valor COMPLETADO y el conector GitHub entrega su solicitud de extracción cuando el trabajo termina.

¿Cómo define la plataforma completamente traducido: todas las cadenas del archivo o todas las cadenas que fueron autorizadas?
Las dos son diferentes cuando se excluyen algunas cadenas de un trabajo. El conector de repositorio de Smartling utiliza todas las cadenas autorizadas de forma predeterminada y se puede cambiar a todas las cadenas.

¿Aparece alguna vez una traducción en curso en una descarga de producción?
Busca un control 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é ocurre cuando un archivo se amplía después de terminar su primer trabajo?
Pregunta cómo trata la plataforma un archivo que pertenece a varios trabajos. La opción de Archivos Totalmente Publicados de Smartling descarga solo archivos completos en todos los trabajos autorizados, hasta 500 por descarga.

¿Cómo se entera la integración de que una traducción entregada se corrigió más tarde?
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 repositorios de Smartling mapea las ubicaciones 1:1; las ubicaciones similares, como es y es-ES, se gestionan creando ambas en Smartling y compartiendo las traducciones a través de 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 califican y qué cubre los vacíos. En el conector de repositorios autohospedado para GitHub, GitLab y Bitbucket, un nodo DownloadTranslations de repo-connector.conf establece el disparador en COMPLETADO (se entrega solo cuando se han completado todas las traducciones del archivo) o ONCHANGE (se entrega cuando una traducción cambia), 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 Gettexto, propiedades de Java, archivos XML personalizados, XML de Android y JSON. La condición de entrega por defecto es que todas las cadenas autorizadas del archivo se publiquen para la configuración regional y se puede cambiar el conector para que requiera todas las cadenas del archivo a través de Solutions Architects o Support de Smartling.

El GitHub Connector alojado crea una rama de traducción y una solicitud de extracción cuando el trabajo termina, con un archivo por idioma, por lo que una solicitud de extracción parcialmente traducida solo aparece cuando se activa la entrega anticipada para un pase prepublicado. Las integraciones directas utilizan la API Files, en la que el punto final de descarga acepta los valores RetrievalType de pendiente, publicado, pseudoy contextMatchingInstrumented; con publicado, las traducciones que aún se están editando o revisando se sustituyen por la cadena fuente y se incluyen las traducciones prepublicadas de la configuración previa a la publicación de un paso del flujo de trabajo. Las llamadas se activan cuando un archivo se completa en una configuración regional y cuando se completa un trabajo, y un punto final de archivos publicados recientemente permite a la integración recoger las traducciones corregidas tras la primera descarga.

Para los equipos que descargan a mano, la pestaña Archivos de un proyecto o un trabajo ofrece traducciones actuales (en curso) o traducciones publicadas, y la pestaña Archivos del trabajo añade Archivos totalmente publicados, que solo devuelve 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 se publica en su totalidad, una descarga estándar sigue conteniendo el texto original en las posiciones sin traducir, por lo que el crítico puede abrir el archivo sin ponerse en blanco. La misma familia de controles cubre los conectores de contenido: los conectores basados en archivos, como Contentful (entradas) y Webflow, ofrecen cada configuración regional una vez que la configuración regional está completamente traducida, y el complemento de WordPress se puede descargar al completar la traducción o al cambiar en progreso, con un tipo de pseudorecuperación para comprobar el diseño.

Preguntas relacionadas

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