L'intégration Phrase Strings (appelée dans l'interface Strings) connecte Phrase TMS et Phrase Strings. L'intégration prend en charge la synchronisation au niveau de la tâche et au niveau du projet.
-
Synchronisation des tâches
Les tâches créées et démarrées dans Strings avec le statut En cours peuvent être importées dans TMS pour traduction et renvoyées à Strings après traduction.
Recommandé pour les flux de travail par lots avec un contrôle granulaire.
-
Synchronisation au niveau du projet
Toutes les clés d'un projet Strings sélectionné sont transférées vers TMS, sans nécessiter la création d'une tâche. Les clés nouvellement ajoutées ou mises à jour deviennent automatiquement disponibles pour la synchronisation.
Recommandé pour les flux de travail de localisation continue.
Prérequis
-
L'accès aux applications TMS et Strings
-
Les codes de langue utilisés dans le projet TMS doivent correspondre aux codes de paramètres linguistiques dans la tâche Strings.
-
La langue par défaut du projet Strings doit être la même que la langue source définie dans le projet TMS.
Important
Les fichiers Figma peuvent être affichés dans Strings dans leur intégralité, sous forme de fichiers actualisés en temps réel, mais ne sont pas pris en charge dans TMS. L'éditeur de TAO de TMS ne peut afficher le contenu traduit que dans un cadre Figma spécifique, au format SVG.
Par défaut, le contenu envoyé depuis Strings vers TMS est importé en tant que fichiers XLIFF 2.0. Lors de l'utilisation de l'APC, le dans les paramètres d'importation de fichiers du modèle de projet TMS doit être défini sur ou .
Les statuts de traduction Strings des clés ne sont pas pris en charge. La synchronisation des tâches envoie le texte cible actuellement stocké dans Strings vers TMS, que la clé soit vérifiée ou non. Les clés marquées comme dans Strings avant l'importation dans TMS peuvent être renvoyées vers Strings comme étant en cas de traductions cibles inchangées.
Le paramètre de projet Strings n'est pas appliqué par la synchronisation des tâches. Aucune substitution par une traduction de repli ne se produit entre Strings et TMS, dans un sens comme dans l'autre ; le texte de la langue de repli ne remplace donc pas les traductions non vérifiées.
Le nombre de segments créés dans TMS après importation d'une tâche Strings peut être différent du nombre de clés d'origine dans les cas suivants :
-
Les clés sont marquées comme exclues dans Strings. Les clés exclues ne sont pas importées.
-
L'option Segmenter XLIFF a été activée dans les paramètres d'importation de fichiers pour XLIFF 2.0 lors de la création de la tâche dans TMS. Dans ce cas, le nombre de segments peut être supérieur au nombre de clés dans Strings.
Les clés Strings peuvent contenir des entités HTML. Lorsque vous configurez le connecteur dans TMS, activez l’option pour préserver les entités HTML au lieu d’afficher les caractères correspondants dans TMS.
Les espaces au début et à la fin du texte source d'une clé Strings ne sont pas affichés dans l'éditeur TAO de TMS. Ces espaces sont conservés dans le squelette et réinsérés dans la source et la cible lorsque la tâche est resynchronisée avec Strings. Cela peut affecter les validations de limite de caractères configurées dans Strings, car le nombre d'espaces n'est pas reflété dans l'éditeur TMS pendant la traduction.
À l'aide du connecteur, il est possible de suivre dans APC plusieurs projets et fichiers. Chaque projet nécessite un suivi individuel au sein d'un APC unique.
Lorsque APC traite un déclencheur de synchronisation de tâche, il crée une tâche TMS pour chaque paramètre régional de Strings. L'ordre d'importation de ces tâches n'est pas garanti et ne peut pas être configuré via le modèle de projet attribué à la règle APC. Aucun mécanisme de tri n’est appliqué à quelque étape que ce soit de ce processus. Pour appliquer un traitement différent à chaque groupe de paramètres régionaux, configurez des règles APC distinctes, chacune pointant vers un modèle de projet différent.
Le connecteur utilise les annotations des paramètres régionaux des tâches pour associer des métadonnées sur le projet Phrase TMS correspondant aux tâches Strings et à leurs paramètres régionaux. Le point de terminaison de l’API Phrase Strings permettant de répertorier les annotations des paramètres régionaux des tâches récupère ces métadonnées. Le point de terminaison pour lister les paramètres régionaux cibles d'une tâche inclut également ces métadonnées lorsque le paramètre include_annotations est défini sur true. Les tâches annotées contiennent des champs tels que tms_project_id et tms_in_progress, qui permettent de suivre le statut d'une tâche Strings dans son projet Phrase TMS lié.
TMS ne permet pas d’utiliser les mêmes paramètres régionaux pour la langue source et la langue cible d’un projet. Par exemple, si une tâche Strings utilise en-US à la fois comme langue source et langue cible, la cible en-US ne peut pas être importée dans TMS, et la tâche globale ne peut pas être marquée comme terminée. Ne sélectionnez pas les paramètres régionaux de la source comme paramètres régionaux cibles lors de la création de tâches dans Strings qui seront synchronisées avec TMS.
Messages ICU et formes plurielles CLDR
Lorsque vous envoyez des tâches Strings contenant des messages ICU ou des formes plurielles à TMS pour traduction, activez l’option dans les paramètres d’importation de fichiers XLIFF 2.0 ou dans les modèles de projet TMS.
Il existe un certain nombre de cas d'utilisation pour le connecteur :
-
Les chefs de projet TMS peuvent ajouter des fichiers directement aux projets TMS depuis un référentiel en ligne.
-
Configurez le portail de l’envoyeur Phrase TMS pour permettre aux envoyeurs d’ajouter directement des fichiers aux demandes de Phrase Strings.
-
Utilisez la création de projets automatisée (APC) de TMS pour que de nouveaux projets soient automatiquement créés lorsqu'une date de dernière modification est détectée pour des fichiers ou un dossier suivis.
-
Pour une synchronisation au niveau de la tâche, configurez l'emplacement surveillé par APC pour qu'il pointe vers le sous-dossier des tâches du projet (par exemple,
All projects / [project name] / [branch] / jobs). -
Pour une synchronisation au niveau du projet, configurez l'emplacement surveillé par APC pour qu'il pointe uniquement vers le chemin du projet et de la branche, sans le sous-dossier des tâches (par exemple,
All projects / [project name] / [branch]). Utilisez une surveillance basée sur un calendrier plutôt qu'une surveillance basée sur des webhooks, car la synchronisation au niveau du projet ne démarre pas de tâche Strings et l'événement webhookjobs:startne se déclenche jamais. -
Pour les synchronisations de tâches, APC est déclenché par les mises à jour des tâches suivantes :
-
Clés nouvellement ajoutées ou modifications apportées à des clés existantes
-
Date d'échéance de la tâche modifiée dans Strings
Remarque
La réouverture des tâches ne compte pas pour une mise à jour pour l’APC.
-
-
Pour les synchronisations au niveau du projet, APC est déclenché par :
-
Clés nouvellement ajoutées
-
Modifications apportées aux clés existantes
-
-
Si l'option est sélectionnée au moment de configurer l'APC, le référentiel en ligne peut être suivi non seulement pour détecter les mises à jour sources, mais également cibles
Si vous choisissez de suivre les mises à jour cibles, toute modification apportée à la copie cible dans le référentiel en ligne mettra à jour automatiquement la mémoire de traduction dans Phrase TMS.
-
Si l'option estsélectionnée, les modifications textuelles des clés dans la langue cible Strings sont automatiquement mises à jour dans les mémoires de traduction TMS utilisées dans le projet APC concerné.
-
-
Le connecteur API TMS peut être utilisée pour automatiser des étapes qui sont sinon effectuées manuellement via l'interface utilisateur. Les webhooks peuvent être utilisés pour notifier certains événements aux systèmes tiers (par exemple, modifier le statut d'une tâche). Des webhooks peuvent être déclenchés pour l'événement
jobs:startpour les synchronisations au niveau de la tâche.
La page fournit une vue centralisée de toutes les configurations de synchros des tâches (APC) utilisant le connecteur Phrase Strings. Elle inclut à la fois les synchros créées directement dans Strings et celles configurées dans TMS, avec les informations pertinentes.
Depuis la page , les administrateurs et les chefs de projet dans Strings peuvent configurer de nouvelles synchronisations des tâches, modifier les synchronisations des tâches existantes (y compris leur statut actif ou inactif) ou les supprimer.
Les synchronisations des tâches existantes peuvent être modifiées ou supprimées en utilisant les options associées dans le menu . Toutes les modifications sont synchronisées entre Strings et TMS. La suppression d'une synchro des tâches supprime l'APC correspondant dans TMS.
La page est accessible à la fois depuis les menus de navigation à gauche et .
Remarque
Si des champs personnalisés sont définis dans TMS, la configuration d'une synchro des tâches depuis Strings n'est pas prise en charge.
Pour configurer une nouvelle synchro des tâches entre Strings et TMS avec une configuration de base, procédez comme suit depuis l'IU de Strings :
-
Dans la page , sélectionnez Configurer à côté de l'intégration .
La page s'affiche.
-
Cliquez sur + Nouvelle synchro des tâches.
La fenêtre s'affiche.
-
Renseignez le champ et sélectionnez le ou les projets Strings à connecter à TMS dans le menu déroulant .
Seuls les projets avec les mêmes combinaisons de langues peuvent être inclus.
-
Vous pouvez (facultatif) sélectionner le à utiliser. Le modèle de projet TMS sélectionné doit correspondre à l'ensemble des langues définies dans le ou les projets Strings assignés.
Les tâches synchronisées seront ajoutées au projet TMS créé à partir du modèle sélectionné.
-
Si l'option est sélectionnée, un modèle de projet TMS est automatiquement créé en fonction des projets Strings sélectionnés.
-
-
Sélectionnez le de projet à créer dans TMS.
-
Option par défaut.
-
Un nouveau projet TMS est créé chaque fois que des changements sont détectés dans les tâches Strings.
-
-
Dans la section , spécifiez les paramètres d'exportation Strings pour contrôler la manière dont les traductions de TMS sont réexportées vers Strings.
-
Met à jour les traductions cibles existantes dans Strings.
-
Marque automatiquement la tâche comme terminée dans Strings.
-
Les clés marquées comme non vérifiées seront automatiquement vérifiées dans Strings en cas de traductions cibles inchangées.
-
-
Si nécessaire, cliquez sur Options avancées pour afficher des options d'exportation supplémentaires.
-
Marque un paramètre linguistique spécifique comme terminé une fois les traductions resynchronisées.
-
Garantit que les nouvelles clés venant de TMS sont créées dans Strings et que les clés existantes sont mises à jour.
-
Empêche l'écrasement des traductions si le texte source a été modifié dans Strings depuis l'exportation.
-
-
Cliquez sur Enregistrer.
La nouvelle configuration de synchro des tâches est ajoutée à la liste avec le statut inactif. Utilisez le commutateur sous la colonne pour activer la synchro des tâches.
Astuce
Pour des configurations plus avancées, configurez le connecteur en utilisant les paramètres Phrase TMS.
Si vous utilisez un mappage personnalisé, toute modification nécessaire doit être apportée au connecteur dans TMS.
La création du connecteur Strings dans Phrase TMS ne crée pas automatiquement d'APC pour l'importation/exportation automatisée des tâches. L'APC doit être configuré séparément dans TMS.
Certaines organisations disposent déjà d'un connecteur Phrase Strings créé automatiquement, utilisant l'identité de l'organisation sur la plateforme Phrase. Vérifiez la liste des connecteurs sur la page avant d'en créer un manuellement. Le connecteur créé automatiquement s'authentifie côté serveur en utilisant l'identité de l'utilisateur connecté, et non un jeton d'accès saisi manuellement.
Le connecteur affiche le statut pendant qu'il termine sa synchronisation initiale après sa création, puis passe à . L'état est également déclenché chaque fois qu'une modification est apportée à la configuration du connecteur ou lorsque la page des paramètres du connecteur est enregistrée, même sans changement significatif. Tant qu'un connecteur affiche , il ne peut pas être utilisé comme source pour la création de tâches dans Phrase TMS. Attendez que le statut passe à avant de créer des tâches avec ce connecteur.
-
À partir de la page des paramètres
, faites défiler vers le bas jusqu'à la section .
-
Cliquez sur Connecteurs.
La page s'ouvre.
-
Cliquez sur Nouveau connecteur.
La page s'ouvre.
-
Modifiez le Type en sélectionnant et donnez un nom au connecteur.
-
Saisissez l’identifiant du compte et le jeton d’accès obtenus auprès de Strings.
-
Cliquez sur Tester la connexion.
-
En cas de succès, une petite coche apparaît à côté du bouton .
-
-
Sélectionnez les éléments à importer dans TMS.
Si des clés cibles ne sont pas importées, le fichier XLIFF 2.0 peut être segmenté davantage si l'option Segmenter XLIFF est sélectionnée sous pour les fichiers XLIFF 2.0.
-
Activez ou désactivez les options d'importation avancées en fonction de vos besoins :
-
La langue source du projet TMS est appliquée, quelle que soit la langue par défaut du projet Strings.
-
Activez cette option pour éviter de créer des tâches TMS en double pour les paramètres régionaux déjà en cours. Lorsqu'elle est activée, les modifications apportées aux clés faisant déjà partie d'une tâche TMS active ne sont pas réimportées tant que la tâche d'origine n'est pas terminée. Recommandé pour un contrôle accru des tâches comportant plusieurs langues.
-
-
Cette option garantit que les entités HTML sont enveloppées dans CDATA pour être préservées lors du transfert entre Strings et TMS.
-
Cette option permet d'importer du contenu combinant la syntaxe ICU et les éléments HTML inline.
-
-
-
-
Sélectionnez un mode d'exportation.
-
Activez ou désactivez les options d'exportation suivantes en fonction de vos besoins :
-
Désactivez pour empêcher la mise à jour des traductions existantes avec le contenu du fichier.
-
Désactivez pour empêcher la création de nouvelles clés et les mises à jour des clés existantes.
-
Les traductions qui ne s'alignent pas avec le dernier contenu source sont exclues lors de la synchronisation. Cela aide à maintenir la cohérence entre le texte source et les traductions, évitant ainsi des traductions obsolètes ou incorrectes.
-
Les clés marquées comme seront automatiquement vérifiées dans Strings en cas de traductions cibles inchangées. Lorsqu'elle est activée, chaque traduction renvoyée par TMS est marquée dans Strings, que le texte ait été modifié ou simplement renvoyé sans changement. Seules les clés dont le texte source a été modifié dans Strings pendant que la tâche était ouverte sont exclues et restent .
-
Marque un paramètre linguistique spécifique comme terminé une fois les traductions resynchronisées.
-
Si cette option est sélectionnée, la tâche ne sera marquée comme terminée que lorsque le dernier paramètre régional sera téléversé.
-
-
-
Le cas échéant, sélectionnez un dossier par défaut (possible uniquement après l'enregistrement).
-
Le est présenté et peut être personnalisé si nécessaire. Assurez-vous que chaque paramètre régional Strings ne possède qu'une seule entrée de mappage vers un seul paramètre régional TMS dans la configuration du connecteur. Les modifications du mappage des langues n'affecteront pas les tâches existantes.
La liste se compose d'une ou plusieurs pages de cinq projets triés par ordre alphabétique ; d'abord de A à Z (en majuscules) puis de a à z (en minuscules).
-
Cliquez sur Enregistrer.
Le connecteur est ajouté à la liste de la page .
Pris en charge dans l’intégration :
-
Flux de travaux TMS
-
Consignes de la tâche (non applicable lors de la synchronisation au niveau du projet)
-
Date d'échéance de la tâche (non applicable lors de l'utilisation de la synchronisation au niveau du projet)
La date d'échéance définie dans Strings mettra à jour la date limite du projet dans TMS. S'il existe plusieurs dates limites différentes, la plus éloignée sera appliquée au projet TMS.
Transféré de Strings à TMS comme projet de référence :
-
Noms des clés
Transférée de Strings et affichée comme clé de contexte dans le volet Note de contexte des éditeurs TAO TMS.
-
Descriptions des clés
Transférée de Strings et affichée comme note de contexte dans le volet Note de contexte des éditeurs de TAO de TMS.
-
Longueur max. de caractères clé
Transféré de Strings et affiché dans le volet Note de contexte des éditeurs TAO de TMS.
-
Captures d'écran
Pour afficher des captures d'écran venant de Strings dans le panneau des éditeurs de TAO TMS :
-
Activez l’option dans la section Accès et sécurité des paramètres du projet TMS.
-
Sélectionnez le format de texte dans le panneau .
-
-
Métadonnées personnalisées dans les formats de fichiers pris en charge :
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
Pour suivre les mises à jour cibles effectuées dans Strings via APC, procédez comme suit :
-
Lors de la configuration d'un APC, sélectionnez fois.
Cela permet de suivre les mises à jour cibles effectuées dans Strings dans le référentiel en ligne.
-
Dans la section Automatisations de la configuration APC, sélectionnez les mises à jour cibles effectuées dans l’entité distante sont automatiquement enregistrées dans la MT.
Les modifications apportées au contenu de langue cible dans Strings seront automatiquement enregistrées dans la mémoire de traduction Phrase TMS lorsque le suivi APC sera déclenché.
Il est possible d’écraser les mises à jour de la mémoire de traduction en modifiant les segments cibles dans l’éditeur Phrase TMS. Ces mises à jour seront exportées vers Strings lorsque la tâche Phrase TMS sera terminée.
Comportement lors de la suppression d’une clé avec APC
La suppression d'une clé dans Strings après son inclusion dans une tâche n'affecte pas une tâche Phrase TMS créée via une importation manuelle ponctuelle. Cette tâche reste inchangée jusqu'à ce qu'elle soit réimportée manuellement.
Lorsque la surveillance APC est active, Phrase compare un hachage du contenu à chaque interrogation ou déclenchement par webhook et traite tout changement, y compris la suppression d'une clé, comme une mise à jour qui déclenche une resynchronisation.
-
En mode , la resynchronisation met à jour le projet ou la tâche Phrase TMS existant pour correspondre au contenu actuel dans Strings, de sorte que le contenu de la clé supprimée est retiré de cette tâche.
-
En mode , la resynchronisation crée une nouvelle version de tâche Phrase TMS reflétant le contenu après suppression, tandis que les versions de tâche précédemment créées restent inchangées.
Le tableau ci-dessous présente les problèmes courants que les utilisateurs peuvent rencontrer en utilisant l'intégration Strings. Il fournit des causes et des solutions possibles de dépannage.
|
Problème |
Cause(s) |
Solution |
|---|---|---|
|
Message d'avertissement lié à |
Les noms clés contiennent des caractères indésirables (par exemple des espaces) |
Les utilisateurs peuvent toujours gérer le contenu traduit et l'exporter vers Strings, malgré le message d'avertissement. |
|
Les clés du TMS sont vides |
La tâche contient des clés sans texte source dans la langue source |
Soit :
|
|
APC ne crée pas de projets/ne traite pas de nouvelles tâches |
Inadéquation des codes langue |
Assurez-vous que les codes de langue dans Strings correspondent avec ceux du projet TMS. Lorsque APC est défini comme un projet continu, toutes les modifications apportées au modèle de projet après la création du projet ne seront pas appliquées aux projets existants. Par conséquent, des modifications doivent être apportées directement aux projets continus. |
|
APC considère la tâche/les paramètres régionaux comme traitée/traités |
Si les paramètres du modèle de projet/de l'APC sont modifiés après le démarrage de la tâche, celle-ci peut être considérée comme traitée dans l'historique APC. Par conséquent, une mise à jour de la tâche peut être nécessaire pour l'itération suivante. Soit :
|
|
|
Erreur |
Réduisez le nombre d’APC et la fréquence de suivi. |
|
|
Une clé existante dans le projet Strings est absente de la tâche TMS |
La clé concernée n'a pas été ajoutée à la tâche Strings |
Ajoutez la clé à la tâche Strings et réimportez la tâche depuis le dépôt en ligne dans TMS |
|
Une erreur « Could not authenticate » apparaît lors de la tentative d'importation ou d'exportation de tâches. |
Jeton d'accès expiré ou révoqué sur le connecteur « created by Phrase Strings » créé automatiquement |
Créez un nouveau connecteur Phrase Strings dans TMS, reliez les APC existants au nouveau connecteur et déclenchez la surveillance. |
|
La tâche Strings est introuvable pour l'importation ou la réimportation, que ce soit via APC ou manuellement, même si elle n'est pas indiquée comme terminée. |
La tâche a déjà été importée dans un projet TMS qui a ensuite été déplacé dans la corbeille sans avoir été terminé ni purgé. Comme le projet est techniquement toujours en cours, la tâche ne peut pas être réimportée. |
Vérifiez les de la tâche à côté de la langue correspondante dans Strings pour confirmer si elle a déjà été importée dans TMS avant de poursuivre le dépannage. Si le projet lié se trouve dans la corbeille, restaurez-le et continuez à travailler dessus directement ou, si le projet n'est pas nécessaire, annulez les tâches et le projet, ou supprimez définitivement le projet via l'API en utilisant le paramètre |
|
La synchronisation des tâches ne peut pas être enregistrée et affiche l’erreur « |
Lors de l’enregistrement, la synchronisation des tâches compare directement les paramètres régionaux cibles du projet Strings à la liste des paramètres régionaux pris en charge nativement par TMS. Cette validation ne tient pas compte des correspondances personnalisées des paramètres régionaux configurées pour le connecteur. |
Pour un projet Strings dont un paramètre régional cible n’est pas pris en charge nativement par TMS, utilisez le connecteur Strings directement dans TMS plutôt que depuis Strings, puis configurez une correspondance personnalisée entre les langues. |
|
Les traductions ne sont pas réexportées vers Strings, bien que les tâches affichent le statut livré dans TMS. |
Le projet ou son modèle comporte un paramètre d’automatisation du statut qui marque le projet (et ses tâches) comme terminé ou livré dès que toutes les tâches sont prétraduites, au lieu d’attendre leur livraison. Les tâches passent ainsi au statut livré sans que l’étape d’exportation vers Strings soit exécutée. Le service d’automatisation ne planifie donc jamais l’exportation et aucune traduction n’est renvoyée vers Strings. |
Dans les paramètres Automatisation du statut du projet du modèle de projet, choisissez plutôt que . Pour les tâches créées manuellement, exportez chaque tâche vers Strings et définissez manuellement son statut sur livré, car les exportations manuelles ne mettent pas automatiquement à jour le statut des tâches. Une fois que toutes les tâches du projet ont le statut livré, le projet est automatiquement marqué comme terminé. |