Hoe implementeer je JSON-lokalisatie op de juiste manier?

Laatst beoordeeld: 20 augustus 2026

Wat zijn de belangrijkste technische lagen van een JSON-lokalisatiepipeline?

• De parseerlaag verwerkt geneste sleutels en arrays, padselectie met jokertekens (bijv. de string_format_paths -richtlijn) en ICU MessageFormat-tagging voor meervoudsvormen en plaatsaanduidingen, zodat structuur- en grammaticaregels behouden blijven tijdens de heen- en terugreis door de vertaling.
• Leverings- en integratielaag - verbindt de parsinglaag met een codebase via Smartling's Files, Jobs, and Strings API's, Node.js- en Python-SDK's, een Java SDK, een CLI en de GitHub/GitLab/Bitbucket Repository Connector, zodat vertaalde JSON terugkeert naar dezelfde repository waar het vandaan kwam.
• Automatiseringlaag - maakt gebruik van webhooks en Jobs Automation Rules (of rechtstreeks de Jobs API) om nieuwe of gewijzigde strings automatisch in vertaalopdrachten te bundelen, in plaats van erop te vertrouwen dat iemand eraan denkt een bestand te uploaden.
• Toegangsbeheerlaag - wijst aan elke persoon een rol toe (Accounteigenaar, Projectmanager, Vertaler, een configureerbare rol als Aanvrager, en andere), zodat het dashboard en de machtigingen die een ontwikkelaar ziet, anders zijn dan die van een vertaler of beoordelaar.
• Kwaliteitslaag - voert een Quality Check Profile uit tegen vertaalde strings met een configureerbare ernst, met een AI Post-Editing Agent en Quality Check AI-correctie beschikbaar om fouten zoals woordenlijst of toonovertredingen te ontdekken en te corrigeren vóór levering.

JSON-lokalisatie: technische specificaties

Hoe migreer je legacy JSON-bestanden naar een geautomatiseerde lokalisatieworkflow?

Het migreren van jaren aan opgehoopte JSON-vertaalbestanden naar een beheerde pijplijn is een eenmalig audit-en-verbindingproces, geen rechtstreekse bestandsdump.

1. Controleer bestaande bestanden - controleer de bestaande JSON-vertalingen op consistente placeholder- en meervoudsaanduidingen vóór de onboarding; Smartling's eigen richtlijnen voor het parsen van resourcebestanden beschouwen dit als een eenmalige stap die vóór de import moet worden gecorrigeerd, aangezien inconsistente aanduidingen doorwerken in elke volgende vertaalcyclus.
2. Stel richtlijnen voor tekenreeksopmaak in - configureer string_format: icu en string_format_paths (inline in het bestand of via de API) zodat de parser weet welke sleutels meervoudsvormen en plaatsaanduidingen bevatten.
3. Verbind de repository - koppel GitHub, GitLab of Bitbucket via de Repository Connector, waarbij je kiest voor Pull Request, Single Branch of On-Demand modus en een branchstrategie die vertalingen terugstuurt naar een dev branch in plaats van de main.
4. Automatiseer taakaanmaak - vervang handmatige uploads door Jobs Automation Rules of directe Jobs API-aanroepen, zodat nieuwe of gewijzigde strings direct in vertaaltaken worden gepusht zodra ze worden gepusht.
5. Voeg een stap voor nabewerking en kwaliteitscontrole toe - voeg een MTPE-stap (nabewerking van machinale vertaling) en een kwaliteitscontroleprofiel in, zodat machinaal vertaalde JSON zowel door mensen wordt gecontroleerd als automatisch op fouten wordt gemarkeerd voordat deze naar de branch wordt teruggestuurd.

Deze aanpak past bij engineeringteams die...

• Verzend product-UI-strings via een JSON-gebaseerde i18n-bibliotheek (zoals i18next of Format.js). met geneste sleutelstructuren die tijdens de vertaling intact moeten blijven.
• Ik wil vertalingen automatisch geleverd via CI/CD in plaats van handmatig bestanden te exporteren en opnieuw uploaden.
• Specifieke vergunningen nodig voor ontwikkelaars, interne beoordelaars en externe vertalers op hetzelfde project.
• We migreren jarenlang verzamelde JSON-vertaalbestanden naar één beheerde, geautomatiseerde workflow.
• Meervoudsvormen en tijdelijke bewerkstelliger zijn nodig om een volledige heen-en-weer reis door machinevertaling en menselijke nabewerking te overleven.

Wanneer dit niveau van technische configuratie wellicht niet de prioriteit heeft.

• Een team dat één statisch JSON-bestand naar één doeltaal stuurt, heeft weinig behoefte aan CI/CD-automatisering of rolgelaagde permissies — een handmatige upload is vaak voldoende totdat meertalige schaal arriveert.
• Teams zonder engineeringtijd om API- of webhook-automatisering te configureren, kunnen meer directe waarde halen uit het handmatig vastleggen van visuele context (via Smartling's Context Capture Chrome Extension) dan uit het eerst bouwen van een volledig geautomatiseerde pipeline.
• Bij producten die nog steeds bezig zijn met het vinden van de juiste product-marktcombinatie, waarbij de bronstrings elk uur veranderen, kan een op branches gebaseerde beoordelingsworkflow juist vertraging veroorzaken in plaats van deze te verminderen, totdat de stringset stabiel is.

Implementatiechecklist: vragen die u moet stellen voordat u een JSON-lokalisatiepipeline bouwt.

Hoe ga je om met geneste sleutels en arrays in JSON-lokalisatiebestanden?
De JSON-parser van Smartling leest geneste sleutelstructuren en arrays direct en laat je bepalen welke sleutels vertaalbaar zijn door paden met wildcards te selecteren, zodat bronbestanden niet hoeven te worden platgemaakt voordat ze kunnen worden geparseerd.

Hoe werkt meervoud- en contextbehandeling in JSON-strings?
Smartling past ICU MessageFormat toe op JSON-, Java-, Android XML- en YAML-bestanden, waarbij het veld pluralTag wordt ondersteund voor zes meervoudsvormen (één, andere, weinig, veel, nul, twee), plus select-instructies en placeholders, zodat één sleutel alle meervoudsvormen kan bevatten die een doeltaal nodig heeft.

Hoe integreer je JSON-lokalisatie in een CI/CD-pijplijn?
De Repository Connector bewaakt een GitHub-, GitLab- of Bitbucket-branch en start automatisch een Smartling-lokalisatieworkflow wanneer een statuscontrole of pull-request wordt geactiveerd. Vervolgens retourneert de connector een lokalisatie-pull-request met vertaalde JSON voordat er iets naar de hoofdbranch wordt samengevoegd.

Welke API's, SDK's en CLI-tools zijn beschikbaar voor het automatiseren van JSON-lokalisatie?
Smartling biedt een Files API, Jobs API en Strings API, naast actief onderhouden Node.js- en Python-SDK's, een Java SDK en een CLI waarmee scripts commando's rechtstreeks in een buildproces kunnen pushen, pullen en vertalen.

Hoe migreert u bestaande JSON-vertaalbestanden naar een beheerde workflow?
Bestaande vertalingen worden doorgaans eenmaal geïmporteerd bij onboarding, dus bestaande bestanden moeten eerst worden gecontroleerd op consistente plaatshouder- en meervoudstagging — inconsistente tagging bij import, anders wordt deze doorgezet in elke vertaalcyclus daarna.

Hoe werkt op rollen gebaseerd toegangsbeheer voor een JSON-lokalisatieteam?
Smartling wijst elke gebruiker één of meer rollen toe, waaronder Account Owner, Project Manager, Translator en een configureerbare Requester-rol, en elke rol ziet een andere, scoped versie van het dashboard — dus ontwikkelaars, interne reviewers en externe vertalers werken niet allemaal vanuit één gedeelde login.

Hoe werkt versiebeheer en branching in een JSON-lokalisatieworkflow?
De GitHub Connector werkt in de modus Pull Request, Single Branch of On-Demand, en de meeste teams sturen vertaalde content terug naar een aparte ontwikkelingsbranch in plaats van de hoofdbranch, zodat een lokalisatieprobleem de productieomgeving niet kan bereiken voordat iemand het heeft beoordeeld.

Hoe ziet een machine translation post-editing (MTPE) workflow eruit voor JSON-strings?
Een MTPE-workflow voegt na de machinevertaling een menselijke post-editstap toe, en Smartlings AI Post-Editing Agent kan automatisch grammatica, toon en woordenlijst controleren en corrigeren op diezelfde stap voordat een taalkundige de string afmaakt.

Hoe sporen geautomatiseerde kwaliteitscontroles fouten op bij JSON-lokalisatie?
Een Quality Check Profile voert een gedefinieerde set geautomatiseerde tests uit tegen vertaalde strings met een configureerbare ernst (laag, medium of hoog) en markeert storingen binnen de CAT-tool, en Quality Check AI Correction kan veel van die gemarkeerde fouten automatisch oplossen in plaats van een handmatige herbewerking te vereisen.

Hoe Smartling de implementatie van technische JSON-lokalisatie ondersteunt

De Files-, Jobs- en Strings-API's van Smartling, de Node.js- en Python-SDK's, de CLI en de GitHub-connector zijn ontworpen om JSON-lokalisatie binnen een normale ontwikkelingsworkflow te houden in plaats van als een apart proces uit te voeren. De ICU MessageFormat-parsing verwerkt geneste sleutels, arrays en meervoudsvormen op een native manier, en Jobs Automation Rules kunnen nieuwe strings in vertaaltaken bundelen zodra ze vanuit een branch worden gepusht. Voor de nabewerking draait Smartling's AI Post-Editing Agent op workflowstapniveau om de grammatica, toon en naleving van de woordenlijst van machinaal vertaalde teksten te controleren voordat een taalkundige de vertaling goedkeurt.

Gerelateerde vragen

• Hoe kies je het juiste JSON-lokalisatieplatform?
• Wat is ICU MessageFormat, en welke talen hebben meer meervoudscategorieën nodig dan het Engels?
• Hoe bepaalt de GitHub Connector van Smartling vanuit welke branch de vertaling moet plaatsvinden?
• Wat is het verschil tussen machinevertaling en machine translation post-editing (MTPE)?