Intégrer à un fournisseur de service de traduction

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Effectuez une intégration avec n’importe quel fournisseur de service de traduction de votre choix pour traduire le texte généré dynamiquement.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Créez des flux secondaires pour détecter la langue du texte d’entrée et traduisez le texte d’entrée à l’aide de flux secondaires, d’actions, de connexions et d’informations d’identification Hub d'intégration .
      Pour plus d’informations, consultez Concepteur de flux.
      1. Assurez-vous que le mappage des messages d’erreur est effectué de manière à mapper les codes d’erreur du fournisseur de service de traduction aux codes d’erreur et aux messages d’erreur standardisés pris en charge par ServiceNow.
        Tableau 1. Codes d’erreur et message standard
        Code d'erreur Message d'erreur
        40050 Code d’erreur pour renseigner les messages d’erreur du fournisseur de service de traduction au lieu de messages d’erreur standardisés.
        40051 Une erreur inconnue s'est produite.
        40052 La longueur maximale du texte (champ de « texte ») a été dépassée.
        40053 La langue source n’est pas valide.
        40054 La langue cible n’est pas valide
        40055 La demande n’est pas autorisée car les informations d’identification sont manquantes ou invalides.
        40056 Le texte ne peut pas être traduit dans les langues cibles.
      2. Assurez-vous que les champs d’entrée et de sortie sont au format suivant pour les flux secondaires.
        Remarque :
        Lorsque vous créez des flux secondaires, vous pouvez vous référer aux flux secondaires disponibles par défaut si nécessaire. Par exemple, Détecter la langue [detect_language_v3] et Traduire le texte vers plusieurs langues [translate_text_to_multiple_languages_v3].
        Tableau 2. Détecter le flux secondaire
        Nom de champ Description Type
        Entrées
        textes Saisissez des textes dont la langue doit être détectée.

        Dans la version, la version v3 prend en charge la Xanadu détection en bloc, c’est-à-dire la détection de plusieurs entrées de textes dans une seule chaîne.

        		 Array.String
        Sorties
        détections Informations sur le code et la fiabilité des langues détectées par le traducteur et leurs alternatives, codes d’erreur et messages d’erreur respectifs.
        • Code : code de langue de la langue détectée, tel que spécifié par le fournisseur de services de traduction.
        • Fiabilité : valeur qui indique la confiance dans le résultat. La valeur se situe entre zéro et un. Une valeur faible indique un faible niveau de confiance.
        Par exemple, un texte en français avec un niveau de confiance de 0,93 
        { 'code' : 'fr',  'confidence' : '0.93'  }

        Pour plus d’informations, consultez la section getDetectedLanguages de DynamicTranslation - Scoped.

        		 Tableau.Objet. Chaque élément de l’objet est une valeur de chaîne.
        statut État de la demande. Choix
        Tableau 3. Traduire le flux secondaire
        Nom de champ Description Type
        Entrées
        textes Textes à traduire.

        Dans la version, la version v3 prend en charge la Xanadu traduction en bloc, c’est-à-dire la traduction de plusieurs textes saisis dans une seule chaîne.

        		 Array.String
        target_languages Tableau de codes de langue vers lesquels le texte doit être traduit.
        Par exemple : 
        ['fr','it']
        		 Chaîne de tableau. Chaque élément du tableau est une valeur de chaîne.
        source_language Code de langue du texte source.
        Par exemple : 
        en
        		 Chaîne
        additional_parameters Tableau de paramètres supplémentaires.
        Par exemple : 
        [{'parameter_name': 'textType', 'parameter_value': 'html'}]
        		 Tableau.Objet. Chaque élément du tableau est un objet avec des valeurs de chaîne.
        Sorties
        traductions Textes traduits dans les langues cibles spécifiées. Chaque élément du tableau est un objet contenant la langue cible et le texte traduit.
        Par exemple : 
        [ 
{'target_language':'fr', 'translated_text':'Bonjour'}, 
{'target_language':'it', 'translated_text':'ciao'} 
]

        Pour plus d’informations, consultez la section getTranslations de DynamicTranslation - Scoped.

        		 Tableau.Objet. Chaque élément du tableau est un objet avec des valeurs de chaîne.
        statut État de la demande. Choix
        Remarque :
        Assurez-vous que le champ Exécuter en tant que est défini sur Utilisateur qui lance la session dans les propriétés du flux.
    2. Créez une configuration de traducteur et activez-la.
      Pour plus d'informations, consultez Créer une configuration de traducteur.