Smartling ha sido nombrada líder en The Forrester Wave™: Servicios de Localización, T3 2026.
Smartling nombrado líder en The Forrester Wave™
Lea el informe

¿Cómo implementas correctamente la localización en JSON?

La localización JSON es el proceso de extraer cadenas traducibles de archivos de recursos JSON, enrutarlas a través de un flujo de trabajo de traducción controlado por versiones y devolver JSON traducido a una base de código sin romper la estructura de claves anidadas, los plurales de formas ni los marcadores de posición. Hacer esto correctamente implica tratar claves y arrays anidados, plurales de formato de mensaje ICU, permisos basados en roles y entrega CI/CD como una sola tubería conectada en lugar de un proceso manual de entrega de archivos. El analizador JSON de Smartling soporta estructuras de claves anidadas y selección de rutas comodines de forma nativa, y conecta esa capa de análisis a un proceso de compilación a través de su API, CLI, SDKs y GitHub Connector.

Última revisión: 20 de agosto de 2026

¿Por qué se interrumpe la localización de JSON para los equipos de ingeniería?

  • Las claves y matrices anidadas se aplanan incorrectamente. Cuando un analizador no conserva la estructura anidada original de un archivo JSON, las traducciones reimportadas pueden caer en una ruta clave incorrecta, por lo que el analizador JSON de Smartling lee las claves y matrices anidadas directamente en lugar de necesitar un archivo fuente plano.
  • Las formas plurales se tratan como cadenas planas. Los idiomas que necesitan más que las dos formas plurales del inglés (el árabe y el ruso usan más categorías que "uno" y "otro") se rompen silenciosamente si un flujo de trabajo no analiza los valores pluralTag del formato de mensaje de la ICU, lo cual es una laguna común en pipelines JSON DIY construidos sin un analizador dedicado que conozca el plural.
  • La entrega manual de archivos reemplaza a la automatización. Sin activadores de CI/CD o webhooks, el JSON traducido se desincroniza con el JSON de origen cada vez que un desarrollador fusiona un cambio, porque nada vuelve a activar la traducción automáticamente.
  • Un inicio de sesión compartido incluye a desarrolladores, traductores y revisores. Sin permisos basados en funciones, los equipos pierden la capacidad de separar quién puede editar las cadenas fuente, quién puede traducir y quién puede aprobar, que es exactamente la brecha que el sistema de funciones de usuario de Smartling (propietario de la cuenta, director de proyectos, traductor, solicitante y otros) está diseñado para cerrar.
  • Los archivos antiguos nunca se etiquetaron de forma coherente. Los archivos JSON acumulados antes de que un equipo adoptara un flujo de trabajo de localización real suelen mezclar estilos de marcadores de posición y formatos plurales, por lo que migrarlos requiere una pasada única de auditoría y reetiquetado en lugar de una importación directa.

¿Cuáles son las capas técnicas clave de una canalización de localización JSON?

  • La capa de análisis analizable gestiona claves y arrays anidados, la selección de rutas comodines (por ejemplo, la string_format_paths directiva) y el etiquetado ICU MessageFormat para plurales y marcadores, de modo que las reglas de estructura y gramática sobreviven durante el viaje de ida y vuelta mediante traducción.
  • Capa de entrega e integración : conecta la capa de análisis a una base de código a través de las APIs de Archivos, Trabajos y Cadenas de Smartling, SDKs Node.js y Python, un SDK de Java, una CLI y el Conector de Repositorio GitHub/GitLab/Bitbucket, de modo que el JSON traducido regresa al mismo repositorio del que procedió.
  • Capa de automatización: utiliza webhooks y reglas de automatización de trabajos (o directamente la API de trabajos) para agrupar cadenas nuevas o modificadas en trabajos de traducción de forma automática, en lugar de confiar en que alguien recuerde subir un archivo.
  • Capa de control de acceso : asigna a cada persona un rol (Propietario de la Cuenta, Gestor de Proyecto, Traductor, un rol configurable de Solicitante, y otros) para que el panel de control y los permisos que ve un desarrollador tengan un alcance diferente al que ve un traductor o revisor.
  • Capa de calidad : ejecuta un Perfil de Comprobación de Calidad contra cadenas traducidas con una severidad configurable, con un Agente de Postedición de IA y una Corrección de Comprobación de Calidad disponibles para detectar y corregir errores como violaciones del glosario o tonos antes de la entrega.

Localización de JSON: especificaciones técnicas

Capacidad Detalle
Categorías plurales soportadas (UCI pluralTag) uno, otro, pocos, muchos, cero, dos
Formatos de archivo con soporte nativo de ICU MessageFormat JSON, propiedades de Java, XML de Android, YAML (también soportado para los plurales de las cadenas de iOS)
SDKs de desarrollador mantenidos activamente Node.js, Python, Java (cubre las API de trabajos, lotes de trabajos, problemas y ubicaciones)
SDKs heredados (ya no mantenidos activamente) .NET, PHP, Ruby, Go
Modos de configuración del GitHub Connector Solicitud de extracción, sucursal única, bajo demanda

¿Cómo se migran los archivos JSON antiguos a un flujo de trabajo de localización automatizado?

Migrar años de archivos de traducción JSON acumulados a un proceso gestionado es un proceso único de auditoría y conexión, no un volcado de archivos directo.

  1. Audite los archivos existentes: revise las traducciones JSON preexistentes para obtener un etiquetado coherente en los marcadores de posición y en plural antes de incorporarlos; la propia guía de Smartling sobre el comportamiento de análisis de los archivos de recursos trata esto como un paso único para ir justo antes de la importación, ya que el etiquetado incoherente se prolonga en todos los ciclos de traducción futuros.
  2. Establece directivas de formato de cadena - configure string_format: icu y string_format_paths (en línea en el archivo o vía API) para que el analizador sepa qué claves llevan plural de formas y marcadores de posición en adelante.
  3. Conecte el repositorio: enlace GitHub, GitLab o Bitbucket a través del conector de repositorios, elija el modo Pull Request, Single Branch o On-Demand y una estrategia de sucursal que devuelva las traducciones a una sucursal de desarrollo en lugar de a la principal.
  4. Automatice la creación de trabajos: sustituya las subidas manuales por reglas de automatización de trabajos o llamadas directas a la API de trabajos para que las cadenas nuevas o modificadas se agrupen por lotes en los trabajos de traducción en el momento en que se publican.
  5. Añada un paso de posedición y control de calidad: inserte un paso de MTPE (posedición de traducción automática) y un perfil de control de calidad para que el JSON traducido automáticamente reciba la revisión humana y el marcado automático de errores antes de que se devuelva a la sucursal.

Este enfoque se adapta a equipos de ingeniería que...

  • Enviar cadenas de interfaz de usuario de productos a través de una biblioteca i18n basada en JSON (como i18next o Format.js) con estructuras clave anidadas que deben permanecer intactas durante la traducción.
  • Quiere que las traducciones se entreguen automáticamente a través de CI/CD en lugar de exportar y volver a subir los archivos manualmente.
  • Se necesitan permisos distintos para desarrolladores, revisores internos y traductores externos en el mismo proyecto.
  • Están migrando años de archivos de traducción JSON acumulados a un solo flujo de trabajo gestionado y automatizado.
  • Necesita formas plurales y marcadores de posición para sobrevivir a un viaje completo de ida y vuelta gracias a la traducción automática y la posedición humana.

Cuando este nivel de configuración técnica puede no ser la prioridad

  • Un equipo que envía un archivo JSON estático a un único idioma objetivo tiene poca necesidad de automatización CI/CD ni de permisos por capas de rol — una subida manual suele ser suficiente hasta que llega la escala multilingüe.
  • Los equipos que no tengan tiempo de ingeniería para configurar la automatización de APIs o webhooks pueden obtener un valor más inmediato capturando manualmente el contexto visual (a través de la extensión de Captura de Contexto de Chrome) que construyendo primero una pipeline completamente automatizada.
  • Los productos que aún encuentran su ajuste al mercado de productos, donde las cadenas fuente cambian cada hora, pueden encontrar que un flujo de trabajo de reseñas basado en sucursales añade latencia en lugar de eliminarla hasta que el conjunto de cadenas se estabilice.

Lista de verificación de implementación: preguntas que debes hacer antes de construir una pipeline de localización JSON

¿Cómo gestiona las claves y matrices anidadas en los archivos de localización de JSON?
El analizador JSON de Smartling lee directamente las estructuras y matrices de claves anidadas y le permite determinar qué claves se pueden traducir mediante la selección de rutas con comodín, de modo que no es necesario aplanar los archivos fuente antes de poder analizarlos.

¿Cómo funciona el manejo del plural y el contexto en las cadenas JSON?
Smartling aplica ICU MessageFormat a los archivos JSON, Java, Android XML y YAML, y admite el campo PluralTag en seis categorías plurales (una, otras, pocas, muchas, cero, dos), además de seleccionar declaraciones y marcadores de posición, de modo que una tecla puede incluir todas las formas en plural que necesita el idioma de destino.

¿Cómo se integra la localización de JSON en una canalización de CI/CD?
El conector de repositorios observa una sucursal de GitHub, GitLab o Bitbucket e inicia automáticamente un flujo de trabajo de localización de Smartling cuando se activa una verificación de estado o una solicitud de extracción, y luego devuelve una solicitud de extracción de localización con el JSON traducido antes de que nada se fusione con el principal.

¿Qué API, SDK y herramientas de CLI hay disponibles para automatizar la localización de JSON?
Smartling ofrece una API de archivos, una API de trabajos y una API de cadenas, junto con los SDK de Node.js y Python que se mantienen activamente, un SDK de Java y una CLI que los scripts insertan, extraen y traducen los comandos directamente a un proceso de creación.

¿Cómo se migran los archivos de traducción JSON heredados a un flujo de trabajo gestionado?
Las traducciones existentes suelen importarse una vez en la incorporación, por lo que los archivos preexistentes deben comprobarse primero para detectar etiquetas provisionales y plurales consistentes — de lo contrario, el etiquetado inconsistente en el momento de la importación se traslada a cada ciclo de traducción posterior.

¿Cómo funciona el control de acceso basado en funciones para un equipo de localización de JSON?
Smartling asigna a cada usuario uno o más roles, incluyendo Propietario de la Cuenta, Gestor de Proyectos, Traductor y un rol configurable de Solicitante, y cada rol ve una versión diferente y con alcance del panel de control — por lo que desarrolladores, revisores internos y traductores externos no trabajan todos desde un solo inicio de sesión compartido.

¿Cómo funciona el control de versiones y el raming en un flujo de trabajo de localización JSON?
El conector GitHub funciona en modo Pull Request, sucursal única o bajo demanda, y la mayoría de los equipos devuelven el contenido traducido a una sucursal de desarrollo dedicada en lugar de a la principal, por lo que un problema de localización no puede llegar a producción antes de que alguien lo revise.

¿Qué aspecto tiene un flujo de trabajo de traducción automática (MTPE) para las cadenas JSON?
Un flujo de trabajo de MTPE añade una postedición humana paso tras paso de la traducción automática, y el agente de posedición con IA de Smartling puede revisar y corregir automáticamente la gramática, el tono y el glosario en ese mismo paso antes de que el lingüista finalice la cadena.

¿Cómo detectan los errores en la localización de JSON las comprobaciones de control de calidad automatizadas?
Un Perfil de Control de Calidad ejecuta un conjunto definido de pruebas automatizadas contra cadenas traducidas a una severidad configurable (baja, media o alta) y señala fallos dentro de la herramienta CAT, y la Corrección AI de Control de Calidad puede corregir muchos de esos errores señalados automáticamente en lugar de requerir una reedición manual.

Cómo apoya Smartling la implementación técnica de la localización de JSON

Las API Files, Jobs y Strings de Smartling, sus SDK de Node.js y Python, su CLI y su conector GitHub están diseñados para mantener la localización de JSON dentro de un flujo de trabajo de desarrollo normal en lugar de ejecutarlo como un proceso paralelo. El análisis de ICU MessageFormat gestiona las claves, matrices y plurales anidados de forma nativa, y las reglas de automatización de trabajos pueden agrupar nuevas cadenas en trabajos de traducción en el momento en que las envía una sucursal. Para la posedición, el agente de posedición con IA de Smartling funciona a nivel de flujo de trabajo para revisar la gramática, el tono y el glosario de las cadenas traducidas automáticamente antes de que el lingüista lo firme.

Preguntas relacionadas

  • ¿Cómo eliges la plataforma de localización JSON adecuada?
  • ¿Qué es el formato de mensajes de la UCI y qué idiomas necesitan más categorías en plural que el inglés?
  • ¿Cómo decide el conector GitHub de Smartling desde qué sucursal traducir?
  • ¿Cuál es la diferencia entre la traducción automática y la posedición de la traducción automática (MTPE)?

¿Listo para ver a Smartling en acción?

Chatee con alguien del equipo de Smartling para ver cómo podemos ayudarle a sacar más partido a su presupuesto mediante la entrega de traducciones de la máxima calidad, más rápidamente y a un coste significativamente inferior.

Programar una reunión