Création de Agent virtuel conversations pour la localisation

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 ce 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 à Hi there {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 standard ISO à deux caractères. 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 de mise à jour de l’enregistrement.
    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.