Traductions utilisant des étiquettes personnalisées et des métadonnées / Blogs / Perficient

La gestion des traductions dans Salesforce peut améliorer considérablement l’expérience utilisateur en présentant le contenu dans plusieurs langues. Pour implémenter cette fonctionnalité, vous devez exploiter les étiquettes personnalisées et les types de métadonnées personnalisées de Salesforce en conjonction avec les composants Web Lightning (LWC). Dans ce blog, je vais vous guider tout au long du processus de configuration des traductions à l’aide de ces outils. De plus, je fournirai un exemple de code, décrirai le résultat attendu et mettrai en évidence les problèmes courants rencontrés lors de la mise en œuvre.

Configuration d’étiquettes personnalisées pour les traductions

Les étiquettes personnalisées dans Salesforce vous permettent de stocker des valeurs de texte pouvant être traduites dans différentes langues. Cette fonctionnalité est cruciale pour maintenir la cohérence des interfaces utilisateur dans les différents paramètres régionaux. De plus, en utilisant des étiquettes personnalisées, vous garantissez que les utilisateurs bénéficient d’une expérience cohérente, quelle que soit leur langue préférée. En conséquence, il améliore la convivialité et la satisfaction des utilisateurs dans diverses régions.

Étapes pour créer des étiquettes personnalisées :

1. Accédez à Étiquettes personnalisées : accédez à Configuration dans Salesforce. Recherchez des étiquettes personnalisées et cliquez dessus.
2. Créer de nouvelles étiquettes : cliquez sur Nouvelle étiquette personnalisée. Entrez un nom (par exemple, WELCOME_MESSAGE) et une valeur par défaut (par exemple, Bienvenue dans notre application !). Enregistrez vos modifications. Répétez l’opération pour chaque étiquette, en vous assurant que les traductions sont ajoutées pour différentes langues.

Création de types de métadonnées personnalisés

Les types de métadonnées personnalisés permettent le stockage de données de configuration qui peuvent être gérées sans modification du code. De plus, ils offrent un moyen flexible de gérer les traductions et d’autres paramètres. De plus, en utilisant des types de métadonnées personnalisées, les administrateurs peuvent effectuer des ajustements directement via l’interface utilisateur, garantissant ainsi une expérience transparente. Par conséquent, cette approche minimise le besoin de déploiements fréquents de code et améliore l’adaptabilité du système.

Étapes pour créer des types de métadonnées personnalisés :

1. Accédez aux types de métadonnées personnalisées : accédez à Configuration. Recherchez les types de métadonnées personnalisées et cliquez dessus.
2. Créez un nouveau type de métadonnées personnalisées : cliquez sur Nouveau type de métadonnées personnalisées. Nommez-le (par exemple, TranslationSettings). Ajoutez des champs tels que Étiquette, Traduction et Langue pour stocker les données pertinentes.
3. Ajouter des enregistrements : accédez à Types de métadonnées personnalisées et sélectionnez Gérer les enregistrements pour votre type. Cliquez sur Nouveau pour créer des enregistrements avec des traductions pour différentes langues.

Développement du composant Web Lightning (LWC)

Le LWC récupérera et affichera dynamiquement les traductions en fonction des préférences linguistiques de l’utilisateur.

Exemple de code :

HTML (translationComponent.html) :

html

<template>

    <lightningcard title={cardTitle}>

        <div class="sldsparound_medium">

            <p>{translatedText}</p>

        </div>

    </lightningcard>

</template>

JavaScript (translationComponent.js) :

javascript

import { LightningElement, wire } from 'lwc';

import getTranslations from '@salesforce/apex/TranslationController.getTranslations';




export default class TranslationComponent extends LightningElement {

    translatedText="";

    cardTitle="Welcome Card";




    @wire(getTranslations)

    handleTranslations({ error, data }) {

        if (data) {

            this.translatedText = data.Translation__c;

        } else if (error) {

            console.error('Error retrieving translations:', error);

        }

    }

}

Contrôleur Apex (TranslationController.cls) :

apex

public with sharing class TranslationController {

    @AuraEnabled(cacheable=true)

    public static TranslationSettings__c getTranslations() {

        // Fetch the translation record based on user preferences

        return [SELECT Translation__c FROM TranslationSettings__c LIMIT 1];

    }

}

Tests et résultats

Après le déploiement du composant, les traductions doivent s’afficher en fonction des paramètres régionaux de l’utilisateur.

Production attendue:

Pour un utilisateur dont la préférence linguistique est définie sur le français, si l’enregistrement de métadonnées personnalisées contient la traduction française, le résultat sera :

Bienvenue dans notre application !

Ce texte remplacera le message anglais par défaut dans le composant.

Problèmes courants et solutions

Problème 1 : la traduction ne s’affiche pas

Problème : Le texte traduit n’apparaît pas comme prévu.

Solution : Assurez-vous que les enregistrements de métadonnées personnalisées sont correctement configurés et associés à la langue appropriée. Vérifiez également si la méthode Apex récupère correctement les données.

Problème 2 : erreurs de méthode Apex

Problème : Des erreurs se produisent lorsque la méthode Apex est appelée.

Solution : Vérifiez que la méthode est correctement annotée avec @AuraEnabled et qu’elle respecte les limites du gouverneur Salesforce. Assurez une gestion appropriée des exceptions et déboguez la logique du contrôleur si nécessaire.

Problème 3 : Valeurs d’étiquette personnalisée incorrectes

Problème : les valeurs des étiquettes personnalisées ne s’affichent pas correctement.

Solution : Vérifiez la configuration des étiquettes personnalisées dans Salesforce. Assurez-vous que l’espace de noms correct est utilisé dans le fichier JavaScript lors de l’importation d’étiquettes et que les traductions sont correctement configurées.

Conclusion

La mise en œuvre de traductions dans Salesforce à l’aide d’étiquettes personnalisées, de types de métadonnées personnalisées et de composants Web Lightning implique la configuration des configurations Salesforce nécessaires, le développement du composant pour gérer dynamiquement les traductions et le dépannage des problèmes courants. En suivant ces étapes, vous pouvez créer une expérience utilisateur multilingue qui améliore l’accessibilité et la satisfaction des utilisateurs dans différents paramètres régionaux.

Si vous rencontrez des difficultés, n’oubliez pas que les outils robustes et les ressources communautaires de Salesforce peuvent vous aider à résoudre les problèmes et à optimiser votre mise en œuvre. Bon codage !

Découvrez-en plus :

Types de métadonnées personnalisées dans Salesforce

Étiquette personnalisée