Come si implementa correttamente la localizzazione JSON?

Ultima revisione: 20 agosto 2026

Quali sono i livelli tecnici fondamentali di una pipeline di localizzazione JSON?

• Layer di parsing - gestisce chiavi annidate e array, selezione di percorsi jolly (ad esempio, la string_format_paths direttiva) e il tag ICU MessageFormat per plurali e segnaposto, così che le regole di struttura e grammatica sopravvivano al viaggio di andata e ritorno fino alla traduzione.
• Livello di distribuzione e integrazione : collega il livello di parsing a una codebase tramite le API File, Job e Stringhe di Smartling, gli SDK Node.js e Python, un SDK Java, una CLI e il connettore per repository GitHub/GitLab/Bitbucket, in modo che il JSON tradotto venga restituito allo stesso repository da cui proviene.
• Livello di automazione - usa webhook e Regole di Automazione dei Lavori (o direttamente l'API dei Lavori) per inserire automaticamente nuove stringhe o quelle modificate in lavori di traduzione invece di affidarsi a qualcuno che si ricordi di caricare un file.
• Livello di controllo accessi - assegna a ciascuna persona un ruolo (Proprietario dell'Account, Project Manager, Traduttore, un ruolo configurabile come Richiedente e altri), così che il dashboard e i permessi che uno sviluppatore vede siano strutturati diversamente da quelli che vede un traduttore o un revisore.
• Livello di qualità - esegue un Profilo di Controllo Qualità su stringhe tradotte a una severità configurabile, con un Agente di Post-Editing AI e una Correzione AI di Controllo Qualità disponibili per individuare e correggere errori come violazioni del glossario o del tono prima della consegna.

Localizzazione JSON: specifiche tecniche

Come si migra i file JSON legacy in un flusso di lavoro di localizzazione automatizzato?

La migrazione di anni di file di traduzione JSON accumulati in una pipeline gestita è un processo di verifica e connessione da eseguire una sola volta, non un semplice trasferimento di file.

1. Audit i file esistenti - rivedere le traduzioni JSON preesistenti per un tag consistente di segnaposto e plurale prima dell'onboarding; Le linee guida di Smartling sul comportamento di parsing dei file di risorse trattano questo come un passaggio una volta da fare prima dell'importazione, poiché il tag incoerente si riporta in ogni ciclo di traduzione futuro.
2. Imposta le direttive string-format - configura string_format: icu e string_format_paths (inline nel file o tramite API) così il parser sa quali chiavi porteranno forme plurali e segnaposto in futuro.
3. Collega il repository : collega GitHub, GitLab o Bitbucket tramite il Repository Connector, scegliendo la modalità Pull Request, Single Branch o On-Demand e una strategia di branch che restituisca le traduzioni a un branch di sviluppo anziché al branch principale.
4. Automatizza la creazione di job - sostituisci i caricamenti manuali con Regole di Automazione dei Lavori o chiamate API dirette ai lavori in modo che le stringhe nuove o modificate vengano aggregate in job di traduzione non appena vengono inserite.
5. Aggiungi un passaggio di post-editing e QA - inserisci un passaggio MTPE (traduzione automatica post-editing) e un Quality Check Profile così che il JSON tradotto a macchina riceva sia una revisione umana che un segnalamento automatico degli errori prima di essere consegnato alla filiale.

Questo approccio è adatto ai team di ingegneri che...

• Invia le stringhe dell'interfaccia utente del prodotto tramite una libreria i18n basata su JSON (come i18next o Format.js). con strutture chiave annidate che devono rimanere intatte durante la traduzione.
• Voglio traduzioni consegnate automaticamente tramite CI/CD invece che esportazioni manuali e ricarichi dei file.
• Servono permessi distinti per sviluppatori, revisori interni e traduttori esterni per lo stesso progetto.
• Stiamo migrando anni di file di traduzione JSON accumulati in un unico flusso di lavoro gestito e automatizzato.
• È necessario che le forme plurali e i segnaposto sopravvivano a un ciclo completo di traduzione automatica e post-editing umano.

Quando questo livello di configurazione tecnica potrebbe non essere la priorità

• Un team che invia un file JSON statico in un singolo linguaggio di destinazione ha poco bisogno di automazione CI/CD o permessi layered per ruolo — un caricamento manuale è spesso sufficiente fino all'arrivo della scala multilingue.
• I team che non hanno tempo di ingegnerizzare per configurare l'automazione di API o webhook possono ottenere un valore più immediato catturando manualmente il contesto visivo (tramite l'estensione Chrome Context Capture di Smartling) piuttosto che costruendo prima una pipeline completamente automatizzata.
• Per i prodotti che stanno ancora cercando di trovare il giusto posizionamento sul mercato, dove le stringhe di origine cambiano di ora in ora, un flusso di lavoro di revisione basato su ramificazioni potrebbe aggiungere latenza anziché eliminarla, fino a quando il set di stringhe non si stabilizza.

Checklist per l'implementazione: domande da porre prima di costruire una pipeline di localizzazione JSON

Come gestisci chiavi annidate e array nei file di localizzazione JSON?
Il parser JSON di Smartling legge direttamente le strutture di chiavi annidate e gli array e ti permette di definire quali chiavi sono traducibili tramite selezione del percorso jolly, così i file sorgente non devono essere appiattiti prima di poter essere analizzati.

Come funzionano i plurali e la gestione del contesto nelle stringhe JSON?
Smartling applica ICU MessageFormat ai file JSON, Java, Android XML e YAML, supportando il campo pluralTag in sei categorie di plurale (uno, altro, pochi, molti, zero, due) oltre a istruzioni select e segnaposto, in modo che una chiave possa contenere tutte le forme di plurale necessarie per una lingua di destinazione.

Come si integra la localizzazione JSON in una pipeline CI/CD?
Il Repository Connector monitora un ramo GitHub, GitLab o Bitbucket e avvia automaticamente un flusso di lavoro di localizzazione Smartling quando viene attivato un controllo di stato o una richiesta di pull, quindi restituisce una richiesta di pull di localizzazione con il JSON tradotto prima che qualsiasi modifica venga unita al ramo principale.

Quali API, SDK e strumenti da riga di comando sono disponibili per automatizzare la localizzazione JSON?
Smartling offre un'API per file, un'API per job e un'API per stringhe, oltre a SDK per Node.js e Python attivamente mantenuti, un SDK per Java e una CLI che permette di eseguire script per inviare, scaricare e tradurre comandi direttamente in un processo di build.

Come si migra i file di traduzione JSON legacy in un flusso di lavoro gestito?
Le traduzioni esistenti vengono tipicamente importate una volta all'onboarding, quindi i file preesistenti dovrebbero essere controllati prima per un tag temporaneo e plurale coerente — altrimenti il tag incoerente all'importazione si trasferisce in ogni ciclo di traduzione successivo.

Come funziona il controllo degli accessi basato sui ruoli per un team di localizzazione JSON?
Smartling assegna a ogni utente uno o più ruoli, tra cui Account Owner, Project Manager, Translator e un ruolo configurabile come Requester, e ogni ruolo vede una versione diversa e con ambito definito della dashboard — quindi sviluppatori, revisori interni e traduttori esterni non lavorano tutti con un unico login condiviso.

Come funzionano il controllo di versione e la ramificazione in un flusso di lavoro di localizzazione JSON?
Il GitHub Connector gira in modalità Pull Request, Single Branch o On-Demand, e la maggior parte dei team instrada i contenuti tradotti verso un branch dedicato invece che verso il principale, quindi un problema di localizzazione non può arrivare in produzione prima che qualcuno lo esamini.

Com'è un flusso di lavoro di post-editing per la traduzione automatica (MTPE) per le stringhe JSON?
Un flusso di lavoro MTPE aggiunge una fase di post-editing umano dopo la traduzione automatica, e l'agente di post-editing AI di Smartling può rivedere e correggere automaticamente grammatica, tono e conformità al glossario in questa stessa fase prima che un linguista finalizzi la stringa.

Come fanno i controlli QA automatizzati a rilevare errori nella localizzazione JSON?
Un Quality Check Profile esegue un insieme definito di test automatizzati su stringhe tradotte a una gravità configurabile (bassa, media o alta) e segnala i guasti all'interno dello strumento CAT, e Quality Check AI Correction può correggere molti di quegli errori segnalati automaticamente invece di richiedere una revisione manuale.

Come Smartling supporta l'implementazione della localizzazione JSON tecnica

Le API File, Jobs e Strings di Smartling, i suoi SDK Node.js e Python, la CLI e il GitHub Connector sono costruiti per mantenere la localizzazione JSON all'interno di un normale flusso di lavoro di sviluppo invece di eseguirla come processo secondario — l'analisi di ICU MessageFormat gestisce nativamente chiavi, array e plurali annidati, e le Jobs Automation Rules possono aggregare nuove stringhe in job di traduzione non appena vengono spinte da un branch. Per il post-editing, l'AI Post-Editing Agent di Smartling funziona a livello di workflow step per rivedere grammatica, tono e conformità glossario sulle stringhe tradotte a macchina prima che un linguista chiuda l'approvazione.

Domande correlate

• Come si sceglie la piattaforma di localizzazione JSON più adatta?
• Cos'è ICU MessageFormat e quali lingue richiedono più categorie al plurale rispetto all'inglese?
• Come fa il connettore GitHub di Smartling a decidere da quale ramo effettuare la traduzione?
• Qual è la differenza tra traduzione automatica e post-editing della traduzione automatica (MTPE)?