Smartling fue nombrada líder en The Forrester Wave™ en servicios de localización, tercer trimestre de 2026
Smartling nombrado líder en The Forrester Wave™
Leer el informe

¿Cómo se implementa correctamente la localización 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, licencias basadas 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é falla la localización 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 ubicar en la ruta de clave incorrecta, razón por la cual el analizador JSON de Smartling lee las claves y matrices anidadas directamente en lugar de requerir 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 transferencia manual de archivos sustituye a la automatización. Sin CI/CD ni activadores de webhook, 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 cubre desarrolladores, traductores y revisores. Sin licencias basadas en roles, los equipos pierden la capacidad de separar quién puede editar cadenas de origen, quién puede traducir y quién puede aprobar, que es precisamente la brecha para cerrar para la que está construido el sistema de rol de usuario de Smartling (Propietario de la Cuenta, Gestor de Proyectos, Traductor, Solicitante y otros).
  • Los archivos heredados nunca se etiquetaron de forma consistente. Los archivos JSON acumulados antes de que un equipo adoptara un flujo de trabajo de localización real a menudo mezclan estilos de marcador de posición y formatos plurales, por lo que migrarlos requiere una auditoría única y una reetiquetación 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 sintáctico con una base de código a través de las API de archivos, trabajos y cadenas de Smartling, los SDK de Node.js y Python, un SDK de Java, una CLI y el conector de repositorio de GitHub/GitLab/Bitbucket, de modo que el JSON traducido regresa al mismo repositorio del que proviene.
  • Capa de automatización : emplea webhooks y reglas de automatización de trabajos (o la API de trabajos directamente) para agrupar automáticamente cadenas nuevas o modificadas en trabajos de traducción, en lugar de depender de 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 las licencias que ve un desarrollador tengan un alcance diferente al que ve un traductor o revisor.
  • Capa de calidad : ejecuta un perfil de control de calidad sobre las cadenas traducidas con un nivel de severidad configurable, con un agente de posedición de IA y una corrección de control de calidad de IA disponibles para detectar y corregir errores como infracciones de glosario o de tono antes de la entrega.

Localización 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)
Kits de desarrollo de software (SDK) para desarrolladores con mantenimiento activo. Node.js, Python, Java (que abarca las API de trabajos, lotes de trabajos, incidencias y configuraciones regionales)
SDKs heredados (ya no mantenidos activamente) .NET, PHP, Ruby, Go
Modos de configuración del GitHub Connector Solicitud de extracción, rama única, bajo demanda

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

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

  1. Auditar archivos existentes - revisar traducciones JSON preexistentes para obtener etiquetas consistentes en marcadores de posición y plural antes de la incorporación; La propia guía de Smartling sobre el comportamiento de análisis de archivos de recursos trata esto como un paso puntual para obtener justo antes de la importación, ya que el etiquetado inconsistente se mantiene en cada ciclo de traducción futuro.
  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. Conecta el repositorio : vincula GitHub, GitLab o Bitbucket a través del Conector de repositorio, eligiendo el modo Solicitud de extracción, Rama única o Bajo demanda y una estrategia de rama que devuelva las traducciones a una rama de desarrollo en lugar de a la principal.
  4. Automatizar la creación de trabajos : sustituye las subidas manuales por Reglas de Automatización de Trabajos o llamadas directas a la API de Jobs para que las cadenas nuevas o modificadas se agrupen en trabajos de traducción en cuanto se envíen.
  5. Agrega un paso de post-edición y QA : inserta un paso MTPE (traducción automática post-edición) y un Perfil de Control de Calidad para que el JSON traducido automáticamente reciba tanto revisión humana como señalamiento automático de errores antes de entregar de nuevo a la sucursal.

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

  • Envía cadenas de interfaz de producto a través de una biblioteca i18n basada en JSON (como i18next o Format.js) con estructuras de claves anidadas que deben mantener intactas mediante la traducción.
  • Quiero traducciones entregadas automáticamente a través de CI/CD en lugar de exportar y volver a subir archivos manualmente.
  • Se necesitan licencias distintas para desarrolladores, revisores internos y traductores externos en el mismo proyecto.
  • Se están migrando años de archivos de traducción JSON acumulados a un flujo de trabajo automatizado y gestionado.
  • Se necesitan formas plurales y marcadores de posición para que el texto sobreviva a un ciclo completo de traducción automática y 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 licencias por capas de rol — una subida manual suele ser suficiente hasta que llega la escala multilingüe.
  • Los equipos que no disponen de tiempo de ingeniería para configurar la automatización de API o webhooks pueden obtener un valor más inmediato al capturar manualmente el contexto visual (a través de la extensión Context Capture de Chrome de Smartling) que al crear primero un sistema automatizado completo.
  • Los productos que aún están en proceso de encontrar su adecuación al mercado, donde las cadenas de origen cambian cada hora, pueden encontrar que un flujo de trabajo de revisión basado en ramas agrega latencia en lugar de eliminarla hasta que el conjunto de cadenas se estabilice.

Lista de verificación para la implementación: preguntas que debe hacer antes de crear un proceso de localización JSON.

¿Cómo gestionas claves anidadas y arrays en archivos de localización JSON?
El analizador JSON de Smartling lee directamente estructuras de claves anidadas y arrays y te permite definir qué claves son traducibles mediante selección de rutas comodines, así que los archivos fuente no necesitan ser aplanados antes de poder analizarlos.

¿Cómo funciona el manejo plural y de contexto en cadenas JSON?
Smartling aplica ICU MessageFormat a archivos JSON, Java, Android XML y YAML, admitiendo el campo pluralTag en seis categorías de plural (uno, otro, pocos, muchos, cero, dos) además de declaraciones select y marcadores de posición, de modo que una clave puede contener todas las formas de plural que necesita un idioma de destino.

¿Cómo integras la localización JSON en una tubería CI/CD?
El Conector de Repositorio vigila una rama de GitHub, GitLab o Bitbucket y automáticamente inicia un flujo de trabajo de localización Smartling cuando se activa una comprobación de estado o una pull request, y luego devuelve una pull request de localización con JSON traducido antes de que nada se fusione con el principal.

¿Qué API, SDK y herramientas de línea de comandos están 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 SDK de Node.js y Python con mantenimiento activo, un SDK de Java y una CLI que automatiza la inserción, extracción y traducción de comandos directamente en un proceso de compilación.

¿Cómo se migran los archivos de traducción JSON heredados a un flujo de trabajo gestionado?
Las traducciones existentes suelen importar una vez en la incorporación, por lo que los archivos preexistentes deben comprobar 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 roles para un equipo de localización 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 GitHub Connector funciona en modo Pull Request, Single Branch o On-Demand, y la mayoría de los equipos enrutan el contenido traducido de vuelta a una rama de desarrollo dedicada en lugar de la principal, así que un problema de localización no llega a producción antes de que alguien lo revise.

¿Cómo es un flujo de trabajo de postedición de traducción automática (MTPE) para cadenas JSON?
Un flujo de trabajo MTPE agrega un paso humano posterior a la edición tras la traducción automática, y el agente de postedición con IA de Smartling puede revisar y corregir automáticamente la gramática, el tono y el cumplimiento del glosario en ese mismo paso antes de que un lingüista finalice la cadena.

¿Cómo detectan los errores en la localización 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 Smartling admite la implementación de localización técnica de JSON

Las API de Smartling para archivos, trabajos y cadenas, sus SDK para Node.js y Python, su interfaz de línea de comandos (CLI) y su conector para GitHub están diseñados para mantener la localización JSON dentro de un flujo de trabajo de desarrollo normal en lugar de ejecutarla como un proceso secundario: el análisis de ICU MessageFormat maneja de forma nativa claves anidadas, matrices y plurales, y las reglas de automatización de trabajos pueden agrupar nuevas cadenas en trabajos de traducción en el momento en que se envían desde una rama. Para la posedición, el agente de posedición con IA de Smartling se ejecuta a nivel de paso del flujo de trabajo para revisar la gramática, el tono y el cumplimiento del glosario en las cadenas traducidas automáticamente antes de que un lingüista dé su aprobación.

Preguntas relacionadas

  • ¿Cómo eliges la plataforma de localización JSON adecuada?
  • ¿Qué es ICU MessageFormat y qué idiomas necesitan más categorías en plural que el inglés?
  • ¿Cómo decide el conector de GitHub de Smartling desde qué rama 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?

Converse con alguien del equipo de Smartling para identificar cómo podemos ayudarle a aprovechar mejor su presupuesto al entregarle traducciones con la más alta calidad, mayor rapidez y a costos mucho más bajos.

Solicitar una reunión