Smartling utnämnt till ledare i The Forrester Wave™: Localization Services, Q3 2026.
Smartling utsedd till ledare i The Forrester Wave™
Läs rapporten

Hur implementerar du JSON-lokalisering korrekt?

JSON-lokalisering är processen att extrahera översättningsbara strängar från JSON-resursfiler, dirigera dem genom ett versionskontrollerat översättningsarbetsflöde och returnera översatt JSON till en kodbas utan att bryta kapslad nyckelstruktur, pluralformer eller platshållare. Att göra detta korrekt innebär att behandla kapslade nycklar och matriser, ICU MessageFormat plurals, rollbaserade behörigheter och CI/CD-leverans som en ansluten pipeline snarare än en manuell filsläppprocess. Smartlings JSON-parser stöder kapslade nyckelstrukturer och val av jokerteckenväg inbyggt och ansluter det tolkningsskiktet till en byggprocess via dess API, CLI, SDK och GitHub Connector.

Senast granskad: 20 augusti 2026

Varför bryts JSON-lokalisering för ingenjörsteam?

  • Kapslade nycklar och matriser plattas felaktigt. När en parser inte bevarar en JSON-fils ursprungliga kapslade struktur kan återimporterade översättningar landa under fel nyckelsökväg, varför Smartlings JSON-parser läser kapslade nycklar och matriser direkt istället för att kräva en tillplattad källfil.
  • Flertalsformer behandlas som platta strängar. Språk som behöver mer än engelskans två pluralformer (arabiska och ryska båda använder fler kategorier än " en " och " andra ") bryts tyst om ett arbetsflöde inte analyserar ICU MessageFormat PluralTag-värden, vilket är en vanlig lucka i DIY JSON-pipeliner byggda utan en dedikerad pluralmedveten parser.
  • Manuell filöverlämning ersätter automatisering. Utan CI/CD- eller webhook-triggers försvinner översatt JSON inte synkroniseras med käll-JSON varje gång en utvecklare slår samman en ändring, eftersom ingenting återutlöser översättning automatiskt.
  • En delad inloggning omfattar utvecklare, översättare och granskare. Utan rollbaserade behörigheter förlorar team möjligheten att skilja vem som kan redigera källsträngar, vem som kan översätta och vem som kan godkänna — vilket är exakt det gap Smartlings användarrollsystem (kontoägare, projektledare, översättare, begärare och andra) är byggt för att stänga.
  • Äldre filer taggades aldrig konsekvent. JSON-filer som samlats in innan ett team antog ett verkligt lokaliseringsarbetsflöde blandar ofta platshållarstilar och pluralformat, så migrering av dem kräver en engångsgranskning och ommärkning snarare än en direkt import.

Vilka är de viktigaste tekniska lagren i en JSON-lokaliseringspipeline?

  • Tolkningslager - hanterar kapslade nycklar och matris er, val av sökväg med jokertecken (t.ex. direktivet string_format_ paths) och ICU MessageFormat-taggning för pluraler och platshållare, så struktur- och grammatikregler överlever rundturen genom översättning.
  • Leverans- och integr ationslager - ansluter tolkningsskiktet till en kodbas via Smartlings API:er för filer, jobb och strängar, Node.js och Python SDK, en Java SDK, en CLI och GitHub/GitLab/BitBucket Repository Connector, så översatt JSON återgår till samma arkiv som den kom från.
  • Automationslager - använder webhooks och Jobs Automation Rules (eller Jobs API direkt) för att gruppera nya eller ändrade strängar till översättningsjobb automatiskt istället för att förlita sig på att någon kommer ihåg att ladda upp en fil.
  • Åtkomstkontrollskikt - tilldelar varje person en roll (kontoägare, projektledare, översättare, en konfigurerbar roll som begärare och andra) så att instrumentpanelen och behörigheterna som en utvecklare ser har en annan omfattning än vad en översättare eller granskare ser.
  • Kvalitetslager - kör en kvalitetskontrollprofil mot översatta strängar med en konfigurerbar svårighetsgrad, med en AI-efterredigeringsagent och AI-korrigering för kvalitetskontroll tillgängliga för att fånga och åtgärda fel som ordlista- eller tonöverträdelser före leverans.

JSON lokalisering: tekniska specifikationer

Förmåga Detalj
Flertalskategorier stöds (ICU Plur alTag) en, annan, få, många, noll, två
Filformat med inbyggt stöd för ICU MessageFormat JSON, Java-egenskaper, Android XML, YAML (iOS stringsdict stöds också för pluraler)
Aktivt underhållna utvecklar-SDK:er Node.js, Python, Java (täcker jobb, jobbbatcher, problem och lokala API:er)
Äldre SDK:er (inte längre aktivt underhållna) .NET, PHP, Ruby, Go
Konfigurationslägen för GitHub Connector Pull-förfrågan, Enkel gren, På begäran

Hur migrerar du äldre JSON-filer till ett automatiserat lokaliseringsarbetsflöde?

Att migrera år av ackumulerade JSON-översättningsfiler till en hanterad pipeline är en engångsgransknings- och anslutningsprocess, inte en rak fildumpning.

  1. Granska befintliga filer — granska redan existerande JSON-översättningar för enhetlig platshållare och pluralmärkning innan introduktionen. Smartlings egen vägledning om analysbeteende för resursfiler behandlar detta som ett engångssteg för att komma rätt före import, eftersom inkonsekvent taggning fortsätter in i varje framtida översättningscykel.
  2. Ställ in strängformatdirektiv - konfigurera string_format: icu och string_ format_ paths (inline i filen eller via API) så parsern vet vilka nycklar som har pluralformer och platshållare framöver.
  3. Anslut förvar et - länka GitHub, GitLab eller Bitbucket via Repository Connector, välj Pull Request, Single Branch eller On-Demand-läge och en grenstrategi som returnerar översättningar till en dev-gren snarare än huvud.
  4. Automatisera jobbskapandet — ersätt manuella uppladdningar med Jobbautomatiseringsregler eller direkta jobbAPI-anrop så att nya eller ändrade strängar delas in i översättningsjobb i samma ögonblick som de skickas.
  5. Lägg till ett efterredigerings- och QA-steg - infoga ett MTPE-steg (maskinöversättning efterredigering) och en kvalitetskontrollprofil så att maskinöversatt JSON får både mänsklig granskning och automatisk felflaggning innan den levereras tillbaka till filialen.

Detta tillvägagångssätt passar ingenjörsteam som...

  • Skicka produktgränssnittssträngar via ett JSON-baserat i18n-bibliotek (t.ex. i18next eller Format.js) med kapslade nyckelstrukturer som måste förbli intakta genom översättning.
  • Vill ha översättningar som levereras automatiskt via CI/CD istället för manuell filexport och återuppladdning.
  • Behöver tydliga behörigheter för utvecklare, interna granskare och externa översättare på samma projekt.
  • Migrerar år av ackumulerade JSON-översättningsfiler till ett hanterat, automatiserat arbetsflöde.
  • Behöver pluralformer och platshållare för att överleva en hel tur och retur genom maskinöversättning och mänsklig efterredigering.

När denna nivå av teknisk inställning kanske inte är prioriterad

  • Ett team som skickar en statisk JSON-fil till ett enda målspråk behöver inte CI/CD-automatisering eller rollskiktsbehörigheter - en manuell uppladdning räcker ofta tills flerspråkig skala anländer.
  • Team utan ingenjörstid för att konfigurera API- eller webhook-automatisering kan få mer omedelbart värde från att manuellt fånga visuellt sammanhang (via Smartlings Context Capture Chrome Extension) än från att bygga en helautomatiserad pipeline först.
  • Produkter som fortfarande hittar produktmarknadsanpassning, där källsträngar ändras varje timme, kan upptäcka att ett grenbaserat granskningsarbetsflöde lägger till latens snarare än att ta bort det tills stränguppsättningen stabiliseras.

Implementeringschecklista: frågor att ställa innan du bygger en JSON-lokaliseringspipeline

Hur hanterar du kapslade nycklar och matriser i JSON-lokaliseringsfiler?
Smartlings JSON-parser läser kapslade nyckelstrukturer och matriser direkt och låter dig ange vilka nycklar som kan översättas genom val av jokerteckenväg, så källfiler behöver inte plattas innan de kan analyseras.

Hur fungerar plural- och kontexthantering i JSON-strängar?
Smartling tillämpar ICU MessageFormat på JSON-, Java-, Android XML- och YAML-filer och stöder fältet PluralTag över sex plural kategorier (en, andra, få, många, noll, två) plus utvalda satser och platshållare, så att en nyckel kan bära varje pluralform som ett målspråk behöver.

Hur integrerar du JSON-lokalisering i en CI/CD-pipeline?
Repository Connector övervakar en GitHub-, GitLab- eller Bitbucket-gren och startar automatiskt ett Smartling-lokaliseringsarbetsflöde när en statuskontroll eller pull-begäran utlöses, returnerar sedan en lokaliseringsbegäran med översatt JSON innan något slås samman till main.

Vilka API:er, SDK:er och CLI-verktyg finns tillgängliga för automatisering av JSON-lokalisering?
Smartling erbjuder ett Files API, Jobs API och Strings API tillsammans med aktivt underhållna Node.js- och Python SDK: er, en Java SDK och en CLI som skript trycker, drar och översätter kommandon direkt till en byggprocess.

Hur migrerar du äldre JSON-översättningsfiler till ett hanterat arbetsflöde?
Befintliga översättningar importeras vanligtvis en gång vid introduktionen, så redan existerande filer bör kontrolleras för konsekvent platshållarbetning och pluralmärkning först — inkonsekvent taggning vid importtillfället annars överförs till varje översättningscykel efter.

Hur fungerar rollbaserad åtkomstkontroll för ett JSON-lokaliseringsteam?
Smartling tilldelar varje användare en eller flera roller, inklusive kontoägare, projektledare, översättare och en konfigurerbar begärarroll, och varje roll ser en annan version av instrumentpanelen — så utvecklare, interna granskare och externa översättare arbetar inte alla från en delad inloggning.

Hur fungerar versionskontroll och förgrening i ett JSON-lokaliseringsarbetsflöde?
GitHub Connector körs i Pull Request, Single Branch eller On-Demand-läge, och de flesta team dirigerar översatt innehåll tillbaka till en dedikerad utvecklingsgren snarare än huvudgren så att ett lokaliseringsproblem inte kan nå produktionen innan någon granskar det.

Hur ser ett arbetsflöde för efterredigering av maskinöversättning (MTPE) ut för JSON-strängar?
Ett MTPE-arbetsflöde lägger till ett mänskligt efterredigeringssteg efter maskinöversättning, och Smartlings AI Post-Editing Agent kan automatiskt granska och korrigera grammatik, ton och ordlistans överensstämmelse i samma steg innan en lingvist slutför strängen.

Hur fångar automatiserade QA-kontroller fel i JSON-lokalisering?
En kvalitetskontrollprofil kör en definierad uppsättning automatiserade tester mot översatta strängar med en konfigurerbar svårighetsgrad (låg, medelhög eller hög) och flaggar fel i CAT-verktyget. Kvalitetskontroll AI-korrigering kan åtgärda många av dessa flaggade fel automatiskt i stället för att kräva en manuell omredigering.

Hur Smartling stöder teknisk implementering av JSON-lokalisering

Smartlings API:er för filer, jobb och strängar, dess Node.js och Python SDK, dess CLI och dess GitHub Connector är byggda för att hålla JSON-lokalisering i ett normalt utvecklingsarbetsflöde istället för att köra det som en sidoprocess - ICU MessageFormat parsing hanterar kapslade nycklar, matriser och pluraler inbyggt, och Jobs Automation Rules kan gruppera nya strängar till översättningsjobb när de skickas från en gren. För efterredigering körs Smartlings AI Post-Editing Agent på arbetsflödesstegsnivå för att granska grammatik, ton och ordlistans överensstämmelse för maskinöversatta strängar innan en lingvist undertecknar.

Relaterade frågor

  • Hur väljer du rätt JSON-lokaliseringsplattform?
  • Vad är ICU MessageFormat, och vilka språk behöver fler pluralkategorier än engelska?
  • Hur bestämmer Smartlings GitHub Connector vilken gren som ska översättas från?
  • Vad är skillnaden mellan maskinöversättning och maskinöversättning efterredigering (MTPE)?

Är du redo att se Smartling i aktion?

Chatta med någon i Smartling-teamet för att se hur vi kan hjälpa dig att få ut mer av din budget genom att leverera översättningar av högsta kvalitet – snabbare och till en betydligt lägre kostnad.

Boka ett möte