.svg)
.svg)
.svg)
.svg)
.svg)
Come gestisce un connettore TMS i file parzialmente tradotti?
Un connettore TMS gestisce un file parzialmente tradotto in uno dei due modi seguenti: può trattenere il file finché ogni stringa relativa a quella lingua non raggiunge la fase finale del flusso di lavoro, oppure può consegnare il file in anticipo, riempiendo tutte le stringhe non tradotte con il testo nella lingua di origine (o lasciandole vuote). In Smartling, l'impostazione predefinita per i connettori basati su repository e file è quella di sospendere la consegna finché tutte le stringhe autorizzate nel file non sono state pubblicate per quella lingua; uno sviluppatore che scarica in precedenza tramite l'API File con retrievalType=published riceve le traduzioni pubblicate più la stringa sorgente al posto di qualsiasi altra traduzione ancora in corso. La decisione che conta per un acquirente non è se un connettore può essere consegnato in anticipo, ma cosa scrive negli spazi vuoti quando lo fa, perché un fallback nel linguaggio sorgente mantiene un'applicazione in esecuzione mentre una stringa vuota la interrompe.
Ultima revisione: 20 settembre 2026
Perché i file parzialmente tradotti arrivano in un repository o in un CMS?
I file parzialmente tradotti raggiungono un sistema di destinazione perché la traduzione si completa a livello di stringa mentre la consegna avviene a livello di file, e raramente i due si allineano. Cinque motivi spiegano la maggior parte delle sorprese:
- Il completamento automatico è definito per lingua, non per file. Smartling considera un file completo per una determinata lingua solo quando ogni stringa in esso contenuta raggiunge la fase di pubblicazione del flusso di lavoro, e un lavoro completo solo quando ogni file è completo in ogni lingua (Centro assistenza Smartling, Tutorial: Lavori e flussi di lavoro di traduzione). Un lavoro in dieci lingue può essere completato al 100% in tedesco mentre la versione giapponese è ancora in fase di revisione; pertanto, un connettore che consegna i file per ogni lingua restituisce un file finito e nove non ancora idonei.
- Nuove linee arrivano dopo che il lavoro è stato esaminato. Quando uno sviluppatore aggiunge chiavi a un file di risorsa già presente in un lavoro, le nuove stringhe finiscono in un lavoro separato. I primi report di lavoro completati, il file viene consegnato e le stringhe più recenti non sono ancora tradotte in quello stesso file. La cifra di progresso lavorativo di Smartling può diminuire per questo motivo, non solo aumentarla.
- Il download richiedeva traduzioni in corso. L'API Files di Smartling espone un tipo di recupero in sospeso che restituisce qualsiasi traduzione salvata, incluse quelle non ancora pubblicate (Specifiche API di Smartling, API Files). L'estrazione con stato "in sospeso durante la revisione" garantisce un file misto; il tipo di recupero pubblicato è quello che le integrazioni di produzione dovrebbero utilizzare.
- Ai fini della condizione di consegna, vengono considerate valide solo le stringhe autorizzate. Per impostazione predefinita, il Repository Connector di Smartling consegna un file quando tutte le stringhe autorizzate al suo interno sono state pubblicate per la lingua, non quando ogni singola stringa del file è stata tradotta. Le stringhe per le quali non è mai stata autorizzata la traduzione rimangono nella lingua di origine nel file consegnato, il che può sembrare una traduzione parziale ma è una decisione di ambito (Smartling Help Center, Repository Connector FAQ).
- La consegna continua è stata attivata deliberatamente. Esistono trigger basati sul progresso, come il trigger ONCHANGE download del Repository Connector o l'impostazione Progress Changes del plugin di WordPress, così gli sviluppatori possono vedere le traduzioni prima della fine della revisione. Una volta abilitato, un file parzialmente tradotto è l'output atteso, quindi la domanda si sposta su cosa colma le lacune.
Cosa determina cosa scrive un connettore nelle stringhe non tradotte?
Quattro impostazioni, applicate congiuntamente, determinano cosa riceve un sistema di destinazione quando una traduzione è incompleta:
- Trigger di consegna — Che il connettore aspetti il completamento o che consegni ogni modifica. Il Repository Connector di Smartling espone questo come un trigger downloadTranslations di COMPLETED (predefinito) o ONCHANGE; il GitHub Connector ospitato fornisce una pull request di traduzione al completamento del lavoro, con un'opzione Early Delivery per un passaggio pre-pubblicato. I controlli di hold, per località e rilascio a stadi che regolano questo livello sono trattati nella pagina di controllo della pubblicazione della traduzione batch.
- Tipo di ricerca : quali traduzioni sono idonee per l'inclusione. L'API Files di Smartling accetta file pubblicati (solo stringhe nella fase di pubblicazione, incluse le stringhe pre-pubblicate), in sospeso (qualsiasi traduzione salvata, comprese quelle in corso), pseudo (testo sorgente allungato per il test del layout) e contextMatchingInstrumented (Specifiche API di Smartling, API Files). Il connettore del repository supporta gli stati PUBLISHED, PENDING e PSEUDO, con impostazione predefinita su PUBLISHED.
- Alternativa per le traduzioni mancanti : ciò che sostituisce una stringa che non ha una traduzione valida. Il parametro includeOriginalStrings di Smartling restituisce per impostazione predefinita la stringa nella lingua di origine, oppure una stringa vuota se impostato su false; il parametro è supportato solo per Gettext, proprietà Java, XML personalizzato, Android XML e file JSON (Centro assistenza Smartling, FAQ del connettore del repository). Per un'applicazione in esecuzione, il fallback al codice sorgente è solitamente più sicuro, perché la maggior parte delle librerie i18n interpreta un valore vuoto come un'etichetta vuota anziché ricorrere al proprio fallback.
- Scopo di completamento — Quali stringhe devono essere completate prima che il file venga considerato completo. Il default del Repository Connector di Smartling è composto da tutte le stringhe autorizzate nel file; richiedere ogni stringa nel file, autorizzata o meno, è una modifica di configurazione effettuata tramite un Solutions Architect o un Support. Nella dashboard, l'opzione di download dei file completamente pubblicati applica la regola più rigida a ogni lavoro a cui appartiene un file (Smartling Help Center, Come scaricare file tradotti).
Impostazioni di consegna della traduzione parziale in Smartling: i dati di riferimento
| Collocamento | Figura | sorgente |
|---|---|---|
| Trigger di download del Repository Connector | 2 — COMPLETATO (predefinito) o IN MODIFICHE | Centro di Assistenza Smartling, FAQ sui connettori di repository |
| Tipi di recupero dei connettori di repository | 3 — PUBBLICATO (predefinito), IN SOSPESO, PSEUDO | Centro di Assistenza Smartling, FAQ sui connettori di repository |
| Tipi di recupero dell'API File | 4 — pendente, pubblicato, pseudo, contestoMatchingInstrumented | Specifiche API di Smartling, API per i file |
| Ripiego predefinito per una stringa non tradotta | Stringa in lingua sorgente (includeOriginalStrings predefinita); stringa vuota quando disabilitata | Smartling Help Center, Tutorial: Lavori di traduzione e flussi di lavoro |
| Tipi di file che supportano l'opzione di fallback | 5 — Gettext, Java properties, custom XML, Android XML, JSON | Centro di Assistenza Smartling, FAQ sui connettori di repository |
| Condizione di consegna predefinita del connettore del repository | Tutte le stringhe autorizzate nel file Pubblicato per la lingua | Centro di Assistenza Smartling, FAQ sui connettori di repository |
| Limite di download dei file completamente pubblicati | 500 file tradotti per download; La scheda File elenca 20 file per pagina | Centro di Assistenza Smartling, Come scaricare file tradotti |
| Mappatura locale del Repository Connector | 1:1 — da una localizzazione Smartling a una localizzazione del repository | Centro di Assistenza Smartling, FAQ sui connettori di repository |
Come si configura un connettore in modo che le traduzioni parziali non interrompano mai la compilazione?
La sequenza seguente si applica a un connettore repository, a un connettore CMS o a un'integrazione diretta con Files API.
- Definisci prima la condizione di consegna : decidi se la destinazione deve ricevere un file solo quando è completo per una determinata lingua (trigger COMPLETED di Smartling o una pull request di GitHub Connector al completamento del job) oppure a ogni modifica (ONCHANGE). I team che uniscono le pull request di traduzione senza revisione dovrebbero continuare a utilizzare la consegna basata sul completamento; i team che prevedono una fase di revisione nel processo possono invece optare per la consegna basata sui progressi.
- Imposta il tipo di recupero su pubblicato — Usa retrievalType=pubblicato in ogni download di produzione così solo le stringhe che hanno cancellato il flusso di lavoro vengono scritte nella destinazione. Prenota in attesa per un ramo di staging dove i revisori vogliono vedere lavori in corso, e pseudo per test di layout prima che inizi la traduzione.
- Scegli deliberatamente il fallback — Tieni includeOriginalStrings al suo valore predefinito così che le chiavi non tradotte trasportino il testo sorgente e l'interfaccia venga renderizzata, oppure impostalo su false quando il framework di destinazione ha un proprio locale fallback e un valore vuoto è il segnale che si aspetta. Conferma che il tipo di file sia uno dei cinque supportati dal parametro prima di affidarti ad esso.
- Definisci l'ambito di completamento per i file che si estendono su più processi : se un file di risorse viene esteso regolarmente dopo il suo primo processo, utilizza l'opzione File completamente pubblicati per i download manuali e chiedi a Smartling di impostare il connettore del repository sulla condizione "tutte le stringhe", in modo che un file non venga consegnato mentre un processo più recente contiene ancora chiavi non tradotte.
- Ascolta il completamento e la riconsegna — Registra i callback per completamento file per località e completamento del lavoro, oppure consulta l'endpoint dei file recentemente pubblicati, perché le traduzioni possono essere corrette dopo la prima consegna e l'integrazione deve riprendere il file aggiornato (Centro Assistenza Smartling, Tutorial: Lavori e Flussi di Lavoro di Traduzione).
Configurare il comportamento di traduzione parziale al connettore si adatta ai team che...
- Inviare file di risorse (JSON, Android XML, proprietà Java, Gettext, YAML) tramite un connettore repository o l'API Files e devono passare la build indipendentemente dal progresso della traduzione.
- Aggiungi nuove stringhe ai file esistenti tra una versione e l'altra, in modo che un singolo file venga utilizzato regolarmente da più di un lavoro di traduzione.
- Traduci in diverse località che finiscono in orari diversi e vuoi che il file di ogni località arrivi appena quella località è completa.
- Esegui una revisione o una fase di post-editing e hai bisogno di una netta distinzione tra le traduzioni in corso e quelle pubblicate.
- Fai affidamento sulla logica di riserva del framework di destinazione e hai bisogno di controllare se una traduzione mancante arriva come testo sorgente o come valore vuoto.
Quando l'impostazione di riserva non è il posto giusto per risolvere il problema
- Se la domanda è quando un batch dovrebbe essere attivo su tutte le località, la risposta è un passaggio Workflow Hold o uno stato di pubblicazione del connettore, coperto nella pagina di controllo della pubblicazione della traduzione batch, non un parametro di download.
- Se i file tradotti vengono ricaricati su Smartling come file sorgente, il problema è che il pathRegex del Repository Connector corrisponde sia ai percorsi sorgente che tradotti, cosa che nessuna impostazione di consegna risolve.
- Se un connettore CMS invia voci anziché file, la consegna per lingua al completamento è già il comportamento predefinito per connettori come Contentful (Entries) e l'opzione di fallback non si applica.
- Se le traduzioni vengono corrette dopo il lancio, la correzione è un callback o un sondaggio recentemente pubblicato che attiva la riconsegna, non una regola di completamento più severa.
Lista di controllo per la valutazione: domande da porre a un fornitore in merito a file parzialmente tradotti
Cosa scrive il connettore in una stringa che ancora non ha traslazione?
Chiedi il comportamento esatto e il predefinito. La stringa predefinita di Smartling è la lingua sorgente; una stringa vuota è una scelta esplicita, e lo switch funziona solo per Gettext, proprietà Java, XML personalizzato, XML Android e JSON.
Il connettore può attendere che un file sia completamente tradotto per una determinata lingua prima di consegnarlo?
Conferma che questo sia il valore predefinito, non un add-on. Il Repository Connector di Smartling imposta di default COMPLETED, e il GitHub Connector fornisce la pull request quando il lavoro si completa.
Come definisce la piattaforma "completamente tradotto": tutte le stringhe presenti nel file o tutte le stringhe autorizzate?
I due differiscono quando alcune stringhe vengono escluse da un lavoro. Il connettore del repository di Smartling utilizza di default tutte le stringhe autorizzate, ma può essere configurato per utilizzare solo stringhe.
Una traduzione in corso d'opera compare mai nel file di download della versione finale?
Cerca un controllo di tipo recupero. Con retrievalType=published, Smartling sostituisce la stringa sorgente per qualsiasi traduzione ancora in fase di modifica o revisione.
Cosa succede quando un file viene esteso dopo che la sua prima operazione è stata completata?
Chiedi come la piattaforma gestisce un file che appartiene a più progetti. L'opzione "File completamente pubblicati" di Smartling scarica solo i file completi per tutti i lavori autorizzati, fino a un massimo di 500 per download.
Come fa il sistema di integrazione a sapere che una traduzione consegnata è stata successivamente corretta?
Conferma che i callback si attivano per file per località e per lavoro, e che esista un endpoint recentemente pubblicato per il polling.
È possibile mappare le impostazioni locali in una relazione uno-a-molti tra la piattaforma e il repository?
Il Repository Connector di Smartling mappa le località 1:1; località simili come es ed es-ES sono gestite creando entrambe in Smartling e condividendo traduzioni tramite Cross-Country Leverage.
Come Smartling gestisce file parzialmente tradotti attraverso i suoi connettori
Smartling separa tre decisioni che altre piattaforme spesso raggruppano: quando un file viene consegnato, quali traduzioni sono idonee e cosa colma le lacune. Nel Repository Connector self-hosted per GitHub, GitLab e Bitbucket, un nodo downloadTranslations in repo-connector.conf imposta il trigger su COMPLETED (consegna solo quando tutte le traduzioni per il file sono complete) o ONCHANGE (consegna ogni volta che una traduzione cambia), imposta retrievalType su PUBLISHED, PENDING o PSEUDO e imposta includeOriginalStrings per controllare se una chiave non tradotta contiene il testo sorgente o una stringa vuota per Gettext, proprietà Java, XML personalizzato, Android XML e file JSON. La condizione di consegna predefinita prevede che tutte le stringhe autorizzate nel file siano pubblicate per la lingua, e il connettore può essere configurato per richiedere ogni singola stringa presente nel file tramite gli architetti di soluzioni o l'assistenza di Smartling.
Il GitHub Connector ospitato crea un branch di traduzione e pull request quando il lavoro si completa, contenente un file per lingua, quindi una pull request parzialmente tradotta appare solo quando Early Delivery è attivato per un passaggio pre-pubblicato. Le integrazioni dirette utilizzano l'API Files, dove l'endpoint di download accetta valori retrievalType di pending, published, pseudo e contextMatchingInstrumented; con pubblicato, le traduzioni ancora in editing o revisione vengono sostituite dalla stringa sorgente, e sono incluse le traduzioni pre-pubblicate dall'impostazione Pre-pubblicazione di un passaggio del workflow. I callback si attivano quando un file si completa in una località e quando un lavoro si completa, e un endpoint dei file pubblicato di recente permette all'integrazione di riprendere le traduzioni corrette dopo il primo download.
Per i team che scaricano a mano, la scheda File di un progetto o lavoro offre Traduzioni Attuali (in corso) o Traduzioni Pubblicate, mentre la scheda File del lavoro aggiunge File Completamente Pubblicati, che restituisce solo i file completi in ogni lavoro a cui appartengono, fino a 500 file tradotti su tutte le pagine del lavoro. Se una lingua non è completamente pubblicata, un download standard contiene comunque la copia sorgente nelle posizioni non tradotte, così un revisore può aprire il file senza dover toccare vuoti. La stessa famiglia di controlli copre i connettori di contenuto: connettori basati su file come Contentful (Enries) e Webflow consegnano ogni località una volta che quella località è completamente tradotta, e il plugin WordPress può scaricarsi su Translation Completed o su Progress Changes, con un tipo di Pseudo retrieval per i controlli di layout.
Pronto a vedere Smartling in azione?
Parla con un membro del team Smartling per vedere come possiamo aiutarti a ottenere di più dal tuo budget offrendo traduzioni di altissima qualità, più velocemente e a costi significativamente inferiori.