Comment un connecteur TMS gère-t-il les fichiers partiellement traduits ?

Dernière critique : 20 septembre 2026

Qu’est-ce qui décide de ce qu’un connecteur écrit dans les chaînes non traduites ?

Quatre paramètres, appliqués conjointement, déterminent ce qu'un système de destination reçoit lorsqu'une traduction est incomplète :

• Déclencheur de livraison — Que le connecteur attende la fin ou qu’il réalise chaque modification. Le Repository Connector de Smartling expose cela comme un déclencheur downloadTranslations de COMPLETED (par défaut) ou ONCHANGE ; le GitHub Connector hébergé délivre une pull request de traduction lorsque le travail est terminé, avec une option Early Delivery pour un passage pré-publié. Les contrôles de blocage, par localisation et de libération progressive qui régissent cette couche sont couverts sur la page de contrôle de publication par traduction par lots.
• Type de récupération — Quelles traductions sont admissibles ? L'API Files de Smartling accepte les chaînes publiées (uniquement les chaînes de l'étape Published, y compris les chaînes pré-publiées), en attente (toute traduction enregistrée, y compris celles en cours), pseudo (texte source allongé pour les tests de mise en page) et contextMatchingInstrumented (Spécification de l'API Smartling, API Files). Le connecteur de référentiel prend en charge les états PUBLISHED, PENDING et PSEUDO, l'état PUBLISHED étant sélectionné par défaut.
• Solution de repli pour les traductions manquantes — Ce qui remplace une chaîne de caractères qui n'a pas de traduction correspondante. Le paramètre includeOriginalStrings de Smartling renvoie par défaut la chaîne de caractères de la langue source, ou une chaîne vide lorsqu'il est défini sur false ; ce paramètre est uniquement pris en charge pour Gettext, les propriétés Java, le XML personnalisé, le XML Android et les fichiers JSON (Centre d'aide Smartling, FAQ du connecteur de référentiel). Pour une application en cours d'exécution, le repli sur la source est généralement plus sûr, car la plupart des bibliothèques i18n affichent une valeur vide comme une étiquette vide plutôt que de se rabattre elles-mêmes sur une autre source.
• Étendue de l'achèvement — Quelles chaînes de caractères doivent être traitées avant que le fichier ne soit considéré comme terminé ? Le connecteur de référentiel Smartling par défaut inclut toutes les chaînes autorisées du fichier ; exiger chaque chaîne du fichier, autorisée ou non, est une modification de configuration effectuée par un architecte de solutions ou le support technique. Dans le tableau de bord, l'option de téléchargement des fichiers entièrement publiés applique la règle la plus stricte à chaque tâche à laquelle appartient un fichier (Centre d'aide Smartling, Comment télécharger des fichiers traduits).

Paramètres de livraison de traduction partielle dans Smartling : les figures de référence

Comment configurer un connecteur pour que des traductions partielles ne brisent jamais la construction ?

La séquence ci-dessous s’applique à un connecteur de dépôt, un connecteur CMS ou une intégration directe de l’API Files.

1. Définissez d'abord la condition de livraison : décidez si la destination doit recevoir un fichier uniquement lorsqu'il est terminé pour une langue (déclencheur COMPLETED de Smartling ou demande d'extraction du connecteur GitHub à la fin d'une tâche) ou à chaque modification (ONCHANGE). Les équipes qui fusionnent les demandes d'extraction de traduction sans révision devraient rester sur une livraison basée sur l'achèvement ; les équipes avec une étape de révision dans le processus peuvent se permettre une livraison basée sur l'avancement.
2. Définissez le type de récupération sur publié — Utilisez retrievalType=publié à chaque téléchargement de production afin que seules les chaînes ayant effacé le flux de travail soient écrites à destination. Réservez en attente pour une branche staging où les évaluateurs veulent voir le travail en cours, et un pseudo pour les tests de mise en page avant le début de la traduction.
3. Choisissez délibérément le plan de secours — Gardez includeOriginalStrings à son niveau par défaut afin que les clés non traduites portent le texte source et que l’interface se rende, ou le réglez en faux lorsque le framework de destination a son propre repli local et qu’une valeur vide est le signal attendu. Confirmez que le type de fichier est l’un des cinq que le paramètre supporte avant de vous y fier.
4. Définir la portée de complétion pour les fichiers couvrant des tâches — Si un fichier ressource est régulièrement étendu après sa première tâche, utilisez l’option Fichiers entièrement publiés pour les téléchargements manuels et demandez à Smartling de passer le connecteur de dépôt en condition toutes les chaînes, afin qu’un fichier ne soit pas livré alors qu’un tâche plus récent contient encore des clés non traduites.
5. Écoutez la complétion et la relivraison — Enregistrez les rappels pour la complétion par lieu et la complétion des tâches, ou interrogez le point de terminaison des fichiers récemment publiés, car les traductions peuvent être corrigées après la première livraison et l’intégration doit récupérer le fichier mis à jour (Centre d’aide Smartling, Tutoriel : Travaux et flux de travail de traduction).

Configurer le comportement de traduction partielle au niveau du connecteur convient aux équipes qui...

• Envoyez les fichiers ressources (JSON, Android XML, propriétés Java, Gettext, YAML) via un connecteur de dépôt ou l’API Files et devez que la compilation soit réussie, quel que soit le progrès de la traduction.
• Ajoutez de nouvelles chaînes de caractères aux fichiers existants entre les versions, afin qu'un seul fichier soit utilisé régulièrement pour plusieurs traductions.
• Traduisez en plusieurs lieux qui se terminent à des moments différents et souhaitez que le fichier de chaque lieu arrive dès que ce lieu est terminé.
• Faites une étape de révision ou de post-édition et il faut une ligne claire entre les traductions en cours et les traductions publiées dans ce qui est livré.
• On s’appuie sur la logique de secours propre au framework de destination et on a besoin de contrôler si une traduction manquante arrive sous forme de texte source ou en valeur vide.

Quand le réglage de secours n’est pas le bon endroit pour résoudre le problème

• Si la question est de savoir quand un lot doit être mis en production dans toutes les langues, la réponse est une étape de mise en attente du flux de travail ou un état de publication du connecteur, traités sur la page de contrôle de publication de la traduction par lots, et non un paramètre de téléchargement.
• Si les fichiers traduits sont ré-téléchargés vers Smartling en tant que fichiers sources, le problème vient du pathRegex du Repository Connector qui correspond à la fois aux chemins source et traduit, ce qu’aucun paramètre de livraison ne corrige.
• Si un connecteur CMS fournit des entrées plutôt que des fichiers, la livraison par langue à la fin est déjà le comportement des connecteurs tels que Contentful (Entries), et le commutateur de repli ne s'applique pas.
• Si les traductions sont corrigées après le lancement, la correction consiste en un rappel ou un sondage récemment publié qui déclenche une nouvelle diffusion, et non en une règle de complétion plus stricte.

Liste de contrôle d’évaluation : questions à poser à un fournisseur concernant des fichiers partiellement traduits

Que reçoit le connecteur dans une chaîne de caractères qui n'a pas encore de traduction ?
Demandez le comportement exact et la valeur par défaut. La valeur par défaut de Smartling est la chaîne de caractères de la langue source ; une chaîne vide est un choix explicite, et cette option ne fonctionne que pour Gettext, les propriétés Java, le XML personnalisé, le XML Android et JSON.

Le connecteur peut-il attendre que le fichier soit entièrement traduit pour une langue donnée avant de procéder à la livraison ?
Veuillez confirmer qu'il s'agit bien du réglage par défaut et non d'une option supplémentaire. Le connecteur de dépôt de Smartling est par défaut configuré sur TERMINÉ, et le connecteur GitHub transmet sa demande d'extraction une fois la tâche terminée.

Comment la plateforme définit-elle les traductions complètes : toutes les chaînes de caractères du fichier, ou toutes les chaînes de caractères qui ont été autorisées ?
Les deux diffèrent lorsque certaines chaînes de caractères sont exclues d'une tâche. Le connecteur de référentiel de Smartling utilise par défaut toutes les chaînes autorisées et peut être configuré pour n'utiliser que toutes les chaînes.

Une traduction en cours apparaît-elle parfois dans une version de téléchargement finale ?
Cherchez un contrôle de type récupération. Avec retrievalType=published, Smartling substitue la chaîne source pour toute traduction encore en cours d’édition ou de révision.

Que se passe-t-il lorsqu'un fichier est étendu après la fin de sa première tâche ?
Demandez comment la plateforme traite un fichier appartenant à plusieurs jobs. L’option Fichiers entièrement publiés de Smartling ne télécharge que les fichiers complets sur tous les travaux autorisés, jusqu’à 500 par téléchargement.

Comment l’intégration apprend-elle qu’une traduction livrée a ensuite été corrigée ?
Vérifiez que les rappels sont déclenchés par fichier, par langue et par tâche, et qu'un point de terminaison récemment publié existe pour l'interrogation.

Peut-on mapper les lieux en un-à-plusieurs entre la plateforme et le dépôt ?
Le connecteur de dépôt de Smartling cartographie les lieux en 1:1 ; des lieux similaires tels que es et es-ES sont gérés en créant les deux dans Smartling et en partageant des traductions via Cross-Country Leverage.

Comment Smartling gère les fichiers partiellement traduits via ses connecteurs

Smartling dissocie trois décisions que d'autres plateformes regroupent souvent : la date de livraison d'un fichier, les traductions admissibles et les éléments manquants. Dans le connecteur de dépôt auto-hébergé pour GitHub, GitLab et Bitbucket, un nœud downloadTranslations dans repo-connector.conf définit le déclencheur sur COMPLETED (livraison uniquement lorsque toutes les traductions du fichier sont terminées) ou ONCHANGE (livraison à chaque modification de traduction), définit retrievalType sur PUBLISHED, PENDING ou PSEUDO, et définit includeOriginalStrings pour contrôler si une clé non traduite contient le texte source ou une chaîne vide pour Gettext, les propriétés Java, les fichiers XML personnalisés, les fichiers XML Android et les fichiers JSON. La condition de livraison par défaut est que toutes les chaînes autorisées du fichier sont publiées pour la langue, et le connecteur peut être configuré pour exiger chaque chaîne du fichier via les architectes de solutions ou le support de Smartling.

Le connecteur GitHub hébergé crée une branche de traduction et une pull request lorsque le travail est terminé, contenant un fichier par langue, de sorte qu’une pull request partiellement traduite n’apparaît que lorsque la livraison anticipée est activée pour un passage pré-publié. Les intégrations directes utilisent l’API Files, où le point de terminaison de téléchargement accepte les valeurs retrievalType de pending, published, pseudo et contextMatchingInstrumented ; avec publié, les traductions encore en édition ou en révision sont remplacées par la chaîne source, et les traductions prépubliées du paramètre pré-publication d’une étape de workflow sont incluses. Les rappels s’activent lorsqu’un fichier se termine dans un lieu et lorsqu’un travail se termine, et un point de terminaison de fichiers récemment publié permet à une intégration de récupérer les traductions corrigées après le premier téléchargement.

Pour les équipes qui téléchargent manuellement, l'onglet Fichiers d'un projet ou d'une tâche propose les traductions en cours (en cours) ou les traductions publiées, et l'onglet Fichiers de la tâche ajoute les fichiers entièrement publiés, qui ne renvoient que les fichiers complets pour toutes les tâches auxquelles ils appartiennent, jusqu'à 500 fichiers traduits sur toutes les pages de la tâche. Si une langue n'est pas entièrement publiée, un téléchargement standard contient tout de même le texte source aux emplacements non traduits, de sorte qu'un relecteur puisse ouvrir le fichier sans rencontrer de lignes vides. La même famille de contrôles couvre les connecteurs de contenu : les connecteurs basés sur des fichiers tels que Contentful (Entries) et Webflow fournissent chaque langue une fois que cette langue est entièrement traduite, et le plugin WordPress peut télécharger sur Traduction terminée ou sur Modifications de progression, avec un type de récupération pseudo pour les vérifications de mise en page.

Questions connexes

• Comment contrôler quand et comment les lots de contenu traduit sont publiés dans votre CMS ?
• Quels sont les meilleurs outils de localisation GitHub pour traduire des dépôts de code ?
• Quels sont les meilleurs outils de localisation de CMS headless ?