Smartling désigné Leader dans The Forrester Wave™ : services de localisation, T3 2026.
Smartling nommé Leader dans la Vague™ Forrester
Lire le rapport

Comment implémenter correctement la localisation JSON ?

La localisation JSON est le processus d'extraction de chaînes traduisibles à partir de fichiers de ressources JSON, de leur acheminement via un flux de travail de traduction contrôlé par version, et de renvoi du JSON traduit à une base de code sans altérer la structure des clés imbriquées, les formes plurielles ou les espaces réservés. Pour ce faire correctement, il faut traiter les clés et les tableaux imbriqués, les pluriels ICU MessageFormat, les permissions basées sur les rôles et la livraison CI/CD comme un pipeline connecté plutôt que comme un processus manuel de dépôt de fichiers. L'analyseur JSON de Smartling prend en charge nativement les structures de clés imbriquées et la sélection de chemin générique, et connecte cette couche d'analyse à un processus de construction via son API, son interface de ligne de commande, ses SDK et son connecteur GitHub.

Dernière évaluation : 20 août 2026

Pourquoi la localisation JSON pose-t-elle problème aux équipes d'ingénierie ?

  • Les clés et les tableaux imbriqués sont aplatis incorrectement. Lorsqu'un analyseur syntaxique ne préserve pas la structure imbriquée d'origine d'un fichier JSON, les traductions réimportées peuvent se retrouver sous le mauvais chemin de clé ; c'est pourquoi l'analyseur JSON de Smartling lit directement les clés et les tableaux imbriqués au lieu de nécessiter un fichier source aplati.
  • Les formes plurielles sont traitées comme des chaînes de caractères plates. Les langues qui nécessitent plus que les deux formes plurielles de l'anglais (l'arabe et le russe utilisent tous deux plus de catégories que « un » et « autre ») se cassent silencieusement si un flux de travail n'analyse pas les valeurs pluralTag de ICU MessageFormat, ce qui est une lacune courante dans les pipelines JSON faits maison construits sans analyseur dédié prenant en charge le pluriel.
  • Les transferts manuels de fichiers remplacent l’automatisation. Sans déclencheurs CI/CD ou webhook, le JSON traduit se désynchronise du JSON source à chaque fois qu’un développeur fusionne un changement, car rien ne redéclenche automatiquement la traduction.
  • Un seul identifiant partagé permet aux développeurs, aux traducteurs et aux relecteurs. Sans autorisations basées sur les rôles, les équipes perdent la possibilité de séparer qui peut modifier les chaînes sources, qui peut traduire et qui peut approuver — ce qui est précisément la lacune que le système de rôles utilisateurs de Smartling (propriétaire du compte, chef de projet, traducteur, demandeur, etc.) vise à combler.
  • Les fichiers hérités n'ont jamais été étiquetés de manière cohérente. Les fichiers JSON accumulés avant qu'une équipe n'adopte un véritable flux de travail de localisation mélangent souvent les styles d'espace réservé et les formats pluriels ; leur migration nécessite donc un audit et un réétiquetage ponctuels plutôt qu'une simple importation.

Quelles sont les couches techniques fondamentales d’un pipeline de localisation JSON ?

  • Couche d'analyse syntaxique : gère les clés et les tableaux imbriqués, la sélection de chemin générique (par exemple, la directive string_format_paths ) et le balisage ICU MessageFormat pour les pluriels et les espaces réservés, afin que la structure et les règles grammaticales survivent à l'aller-retour lors de la traduction.
  • Couche de livraison et d’intégration - relie la couche d’analyse syntaxique à une base de code via les API de fichiers, jobs et chaînes de Smartling, SDK Node.js et Python, un SDK Java, une interface de cli, et le connecteur de dépôt GitHub/GitLab/Bitbucket, de sorte que le JSON traduit renvoie au même dépôt d’origine.
  • Couche d’automatisation - utilise des webhooks et des règles d’automatisation des emplois (ou directement l’API des emplois) pour regrouper automatiquement de nouvelles chaînes ou des chaînes modifiées en tâches de traduction, au lieu de dépendre de quelqu’un pour se souvenir de télécharger un fichier.
  • La couche de contrôle d’accès attribue à chaque personne un rôle (Propriétaire de compte, Chef de projet, Traducteur, un rôle de Demandeur configurable, et autres) afin que le tableau de bord et les autorisations qu’un développeur voit soient conçus différemment de ce qu’un traducteur ou un relecteur voit.
  • Couche de qualité - exécute un profil de contrôle qualité sur les chaînes traduites à un niveau de gravité configurable, avec un agent de post-édition IA et une correction IA de contrôle qualité disponibles pour détecter et corriger les erreurs telles que les violations de glossaire ou de ton avant la livraison.

Localisation JSON : spécifications techniques

Capacité Détail
Catégories plurielles prises en charge (ICU pluralTag) un, autre, peu, plusieurs, zéro, deux
Formats de fichiers compatibles avec le format de message ICU natif JSON, propriétés Java, XML Android, YAML (stringsdict iOS également pris en charge pour les pluriels)
Kits de développement logiciels (SDK) activement maintenus Node.js, Python, Java (couvrant les emplois, les lots de tâches, les problèmes et les API locales)
SDKs hérités (non maintenus activement) .NET, PHP, Ruby, Go
Modes de configuration du connecteur GitHub Demande d'extraction, branche unique, à la demande

Comment migrer les fichiers JSON hérités vers un flux de travail automatisé de localisation ?

La migration de plusieurs années de fichiers de traduction JSON accumulés dans un pipeline géré est un processus d'audit et de connexion ponctuel, et non un simple transfert de fichiers.

  1. Auditer les fichiers existants – revoir les traductions JSON préexistantes pour un balisage cohérent et au pluriel avant l’intégration ; Les propres directives de Smartling sur le comportement d’analyse des fichiers de ressources considèrent cela comme une étape unique à régler avant l’importation, car un balisage incohérent se poursuit dans chaque cycle de traduction futur.
  2. Définissez les directives de format de chaîne - configurez string_format: icu et string_format_paths (en ligne dans le fichier ou via API) afin que l’analyseur sache quelles clés portent des formes plurielles et des placeholders à l’avenir.
  3. Connectez le dépôt : liez GitHub, GitLab ou Bitbucket via le connecteur de dépôt, en choisissant le mode Pull Request, Single Branch ou On-Demand et une stratégie de branche qui renvoie les traductions vers une branche de développement plutôt que vers la branche principale.
  4. Automatisez la création de tâches : remplacez les chargements manuels par des règles d’automatisation des tâches ou des appels directs à l’API des tâches afin que les chaînes nouvelles ou modifiées soient regroupées dans les tâches de traduction dès leur envoi.
  5. Ajoutez une étape de post-édition et d'assurance qualité : insérez une étape MTPE (post-édition de traduction automatique) et un profil de contrôle qualité afin que le JSON traduit automatiquement soit soumis à une relecture humaine et à un signalement automatique des erreurs avant d'être renvoyé à la branche.

Cette approche convient aux équipes d’ingénierie qui...

  • Distribuez les chaînes de caractères de l'interface utilisateur du produit via une bibliothèque i18n basée sur JSON (telle que i18next ou Format.js). avec des structures clés imbriquées qui doivent rester intactes lors de la traduction.
  • Je souhaite que les traductions soient livrées automatiquement via CI/CD au lieu d'exporter et de recharger manuellement les fichiers.
  • Besoin d’autorisations distinctes pour les développeurs, les évaluateurs internes et les traducteurs externes sur le même projet.
  • Nous sommes en train de migrer des années de fichiers de traduction JSON accumulés vers un flux de travail unique, géré et automatisé.
  • Il faut des formes plurielles et des espaces réservés pour que le texte puisse supporter un aller-retour complet entre la traduction automatique et la post-édition humaine.

Lorsque ce niveau de configuration technique n'est pas forcément la priorité

  • Une équipe qui déploie un seul fichier JSON statique dans un seul langage cible a peu besoin d'automatisation CI/CD ou d'autorisations à plusieurs niveaux de rôle ; un téléchargement manuel suffit souvent jusqu'à ce que le déploiement multilingue devienne la norme.
  • Les équipes qui n'ont pas le temps d'ingénierie nécessaire pour configurer l'automatisation des API ou des webhooks peuvent tirer un avantage plus immédiat de la capture manuelle du contexte visuel (via l'extension Chrome Context Capture de Smartling) que de la construction préalable d'un pipeline entièrement automatisé.
  • Les produits qui sont encore à la recherche d'une adéquation produit-marché, et dont les chaînes de caractères sources changent d'heure en heure, peuvent constater qu'un flux de travail de révision basé sur les branches ajoute de la latence au lieu de la supprimer jusqu'à ce que l'ensemble de chaînes se stabilise.

Checklist d’implémentation : questions à poser avant de construire un pipeline de localisation JSON

Comment gérez-vous les clés imbriquées et les arrays dans les fichiers de localisation JSON ?
L'analyseur JSON de Smartling lit directement les structures de clés imbriquées et les tableaux et vous permet de définir les clés traduisibles grâce à la sélection de chemin générique, de sorte que les fichiers sources n'ont pas besoin d'être aplatis avant de pouvoir être analysés.

Comment fonctionnent le pluriel et la gestion du contexte dans les chaînes JSON ?
Smartling applique ICU MessageFormat aux fichiers JSON, Java, Android XML et YAML, prenant en charge le champ pluralTag à travers six catégories plurielles (un, autre, peu, beaucoup, zéro, deux) ainsi que des instructions select et des espaces réservés, de sorte qu'une clé peut transporter toutes les formes plurielles dont une langue cible a besoin.

Comment intégrer la localisation JSON dans un pipeline CI/CD ?
Le connecteur de dépôt surveille une branche GitHub, GitLab ou Bitbucket et lance automatiquement un flux de travail de localisation Smartling lorsqu'une vérification d'état ou une demande d'extraction est déclenchée, puis renvoie une demande d'extraction de localisation avec du JSON traduit avant toute fusion dans la branche principale.

Quelles API, quels SDK et quels outils CLI sont disponibles pour automatiser la localisation JSON ?
Smartling propose une API de fichiers, une API de tâches et une API de chaînes de caractères, ainsi que des SDK Node.js et Python activement maintenus, un SDK Java et une interface de ligne de commande (CLI) qui permet d'envoyer, de récupérer et de traduire des commandes directement dans un processus de compilation.

Comment migrer les fichiers de traduction JSON hérités vers un flux de travail géré ?
Les traductions existantes sont généralement importées une fois lors de l’intégration, donc les fichiers préexistants doivent d’abord être vérifiés pour un balisage temporaire et pluriel cohérents — un balisage incohérent au moment de l’importation se retrouve sinon dans chaque cycle de traduction ultérieur.

Comment fonctionne le contrôle d’accès basé sur les rôles pour une équipe de localisation JSON ?
Smartling attribue à chaque utilisateur un ou plusieurs rôles, notamment propriétaire du compte, chef de projet, traducteur et un rôle de demandeur configurable, et chaque rôle voit une version différente et limitée du tableau de bord — de sorte que les développeurs, les réviseurs internes et les traducteurs externes ne travaillent pas tous à partir d'une seule connexion partagée.

Comment fonctionnent le contrôle de version et la gestion des branches dans un flux de travail de localisation JSON ?
Le GitHub Connector fonctionne en mode Pull Request, Single Branch ou On-Demand, et la plupart des équipes acheminent le contenu traduit vers une branche de développement dédiée plutôt que vers la principale, donc un problème de localisation ne peut pas atteindre la production avant qu’un autre ne le teste.

À quoi ressemble un flux de travail de post-édition de traduction automatique (MTPE) pour les chaînes JSON ?
Un workflow MTPE ajoute une étape humaine post-édition après la traduction automatique, et l’agent de post-édition IA de Smartling peut automatiquement revoir et corriger la grammaire, le ton et la conformité au glossaire à cette même étape avant qu’un linguiste ne finalise la chaîne.

Comment les vérifications QA automatisées détectent-elles les erreurs dans la localisation JSON ?
Un profil de contrôle qualité exécute un ensemble défini de tests automatisés sur les chaînes traduites à un niveau de gravité configurable (faible, moyen ou élevé) et signale les échecs dans l'outil CAT, et la correction par IA du contrôle qualité peut corriger automatiquement bon nombre de ces erreurs signalées plutôt que de nécessiter une réédition manuelle.

Comment Smartling prend en charge la mise en œuvre de la localisation technique JSON

Les API de fichiers, jobs et chaînes de Smartling, ses SDK Node.js et Python, sa interface de ligne de commande, et son connecteur GitHub sont conçus pour maintenir la localisation JSON dans un flux de développement normal au lieu de l’exécuter comme un processus parallèle — l’analyse ICU MessageFormat gère nativement les clés, tableaux et pluriels imbriqués, et les règles d’automatisation des emplois peuvent regrouper de nouvelles chaînes en tâches de traduction dès qu’elles sont poussées depuis une branche. Pour la post-édition, l’agent de post-édition IA de Smartling s’exécute au niveau des étapes du workflow pour examiner la grammaire, le ton et la conformité au glossaire sur les chaînes traduites automatiquement avant qu’un linguiste ne valide.

Questions connexes

  • Comment choisir la bonne plateforme de localisation JSON ?
  • Qu’est-ce que le format de message ICU, et quelles langues ont besoin de plus de catégories plurielles que l’anglais ?
  • Comment le connecteur GitHub de Smartling détermine-t-il la branche à partir de laquelle effectuer la traduction ?
  • Quelle est la différence entre la traduction automatique et la post-édition de la traduction automatique (MTPE) ?

Prêt à voir Smartling en action ?

Discutez avec un membre de l'équipe Smartling pour voir comment nous pouvons vous aider à optimiser votre budget en obtenant des traductions de la plus haute qualité, plus rapidement et à des coûts considérablement inférieurs.

Programmer un entretien