Création de conversations pour la Agent virtuel localisation

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture
  • Utilisez des méthodes de localisation dans vos Agent virtuel scripts pour vous assurer que le contenu peut être traduit. Les méthodes de localisation sont conçues pour afficher le texte d’origine lorsqu’aucune traduction n’est trouvée. Ces méthodes peuvent être appliquées à votre code avant que vous n’ayez créé des traductions.

    Méthode de localisation du contenu du message

    La méthode gs.getMessageLang recherche dans la table des messages [sys_ui_message] une version traduite du texte dans la langue sélectionnée pour l’utilisateur actuel. Si aucune version traduite n’est trouvée, la langue par défaut (anglais) est renvoyée.

    Ce code fournit un message d’accueil qui ajoute dynamiquement la valeur de la variable first_name .

    (function execute() {
            return 'Hi there ' + vaInputs.first_name;
    })()

    L’exemple suivant montre le même code réécrit pour la localisation.

    (function execute() {
             return gs.getMessageLang('Hi there {0}', vaContext.getRequesterLang()), [vaInputs.first_name]);
    })()

    Le deuxième exemple utilise la méthode gs.getMessageLang . Le texte est le même que dans l’exemple précédent, mais le format est modifié. Le nombre entre parenthèses sert d’espace réservé pour la variable, qui est ensuite répertoriée dans un tableau après la virgule : [vaInputs.first_name]. La méthode gs.getMessageLang recherche un enregistrement dans la table Message avec une valeur de clé correspondant à Bonjour {0} et une valeur de langue correspondant à la langue du demandeur. La méthode renvoie la version traduite du texte, qui est stockée dans le champ Message de l’enregistrement.

    Remarque :
    Les valeurs de langue utilisent des codes de langue à deux caractères de la norme ISO. Pour plus d’informations, consultez les codes de langue ISO 639.1.
    Figure 1. Exemple d’enregistrement de traduction dans la table Message
    Un enregistrement de traduction dans la table Message affiche la colonne Clé, la langue, le message traduit et la date à laquelle l’enregistrement a été mis à jour.
    Remarque :
    Le contenu est traduit uniquement pour les rubriques publiées. Le contenu n’apparaît pas traduit lors de l’aperçu des rubriques non publiées.