Constante

Les ressources constantes dans Avonni Dynamic Components vous permettent de définir des valeurs fixes qui peuvent être réutilisées dans tout votre composant. Contrairement aux variables, les constantes ne peuvent pas être modifiées après leur définition initiale. Cela les rend idéales pour stocker des valeurs qui doivent rester cohérentes, comme les paramètres de configuration, les valeurs par défaut ou les informations de consultation.

1. Aperçu

Une ressource Constant est une valeur nommée qui est définie une seule fois et reste inchangée pendant tout le cycle de vie du Dynamic Component. Cela offre plusieurs avantages :

• Configuration centralisée : Stockez les valeurs importantes en un seul endroit, ce qui facilite leur mise à jour sans avoir à rechercher dans plusieurs composants ou interactions.

• Lisibilité : Utiliser un nom de Constant descriptif (par ex., DEFAULT_COUNTRY_CODE) rend la configuration de votre composant plus facile à comprendre que l'utilisation d'une valeur codée en dur (par ex., 'US').

• Maintenabilité : Si une valeur constante doit changer (par ex., un nouveau code pays par défaut), vous n'avez besoin de la mettre à jour qu'à un seul un endroit (la ressource Constant).

• Sécurité de type : Les constantes ont un type de données défini (Texte, Nombre, Booléen, etc.), ce qui aide à prévenir les erreurs.

2. Cas d'utilisation

Voici quelques scénarios courants où les ressources Constant sont utiles :

• Valeurs par défaut : Fournir des valeurs par défaut pour les champs de saisie, les filtres ou d'autres paramètres du composant. Exemple : un code pays par défaut pour un formulaire d'adresse.

• Paramètres de configuration : Stocker des options de configuration qui contrôlent le comportement de votre composant. Exemple : un nombre maximal d'enregistrements à afficher dans une liste.

• Valeurs de consultation : Définir un ensemble de valeurs fixes qui peuvent être utilisées dans des comparaisons ou des calculs. Exemple : codes d'état, noms de catégories, codes d'erreur.

• Points de terminaison API (à considérer avec prudence) : Vous pourraient stocker une URL de point de terminaison API en tant que constante, mais faites attention si le point de terminaison risque de changer (par ex., entre les environnements de développement, de test et de production). Les Custom Metadata Types ou les Named Credentials sont généralement de meilleurs choix pour les points de terminaison API.

• Drapeaux booléens : Utilisez des constantes booléennes pour représenter des états ou conditions fixes. Exemple : IS_DEBUG_MODE (défini sur Cet attribut est ou false).

• Identifiants de type d'enregistrement : Stockez les identifiants de type d'enregistrement.

3. Création d'une ressource Constant

Pour créer une ressource Constant dans votre Avonni Dynamic Component :

1. Ouvrez le panneau Ressources : Cliquez sur l'icône bouton Ressources (généralement situé dans l'éditeur de page ou le panneau du composant).

2. Créez une nouvelle ressource : Cliquez sur le bouton pour créer une nouvelle ressource (souvent une icône "+" ou un bouton libellé "New Resource").

3. Sélectionnez "Constant" : Choisissez "Constant" comme type de ressource.

4. Configurez la Constant :

   • Nom API : Saisissez un identifiant unique pour la constante. Utilisez un nom descriptif qui suit une convention de nommage cohérente (par ex., DEFAULT_COUNTRY_CODE, MAX_LIST_ITEMS). Ce nom est la manière dont vous référencerez la constante dans votre composant. Le nom API doit être unique.

   • Description (optionnelle) : Fournissez une brève description de l'objectif de la constante. Cela est utile pour la documentation et la maintenabilité.

   • Type de données : Sélectionnez le type de données approprié pour la constante :

     • Booléen : Cet attribut est ou false.

     • Date : Une valeur de date (par ex., 2024-07-26).

     • Date/Heure : Une valeur de date et heure (par ex., 2024-07-26T14:30:00Z).

     • Nombre : Une valeur numérique (entier ou décimal).

     • Enregistrement : Utilisé pour stocker une référence à un enregistrement Salesforce, généralement par son ID. Vous ne définirez généralement pas tous les champs d'un enregistrement ici. Au lieu de cela, vous stockerez l'ID de 15 ou 18 caractères de l'enregistrement.

     • Texte : Une chaîne de texte.

   • Valeur : Saisissez initial et seulement valeur pour la constante. Cette valeur ne peut pas être modifiée après la création de la constante. La valeur fournie doit correspondre au type de données.

4. Utilisation d'une ressource Constant

Une fois que vous avez créé une ressource Constant, vous pouvez facilement y faire référence dans la configuration de votre Dynamic Component. Vous n'avez pas besoin de taper une syntaxe spéciale manuellement. À la place, vous sélectionnerez la Constant dans une liste :

1. Localisez la propriété : Dans le panneau des propriétés du composant (ou dans les paramètres d'une interaction), trouvez la propriété où vous souhaitez utiliser la valeur de la Constant. Il peut s'agir d'une valeur de filtre, d'une valeur par défaut d'un composant, du contenu d'un champ de texte, etc.

2. Sélectionnez la ressource : Recherchez une liste déroulante, un bouton de sélection ou une icône (souvent une icône variable/ressource) à côté de la propriété. Cela indique que vous pouvez choisir une valeur dynamique. Cliquez dessus.

3. Choisissez votre Constant : Les ressources disponibles (variables et constantes) seront affichées. Sélectionnez votre ressource Constant dans la liste. Le système insérera automatiquement la référence correcte à la Constant. Elle est généralement affichée entre accolades { }.

Exemples :

• Dans un filtre : Vous configurez un filtre sur une table de données. Vous voulez filtrer par Pays. Au lieu de taper 'US', vous cliquez sur le bouton de sélection de ressource à côté du champ "Value" et choisissez votre DEFAULT_COUNTRY_CODE constante dans la liste.

• Dans une propriété de composant : Vous définissez la valeur par défaut d'un composant Text Input. Au lieu de taper la valeur par défaut directement, vous cliquez sur le bouton de sélection de ressource et choisissez votre Constant.

• Visibilité conditionnelle : Si vous avez créé une constante nommée SHOW_ADVANCED_OPTIONS de type Booléen, dans une condition de visibilité, sélectionnez directement votre Constant parmi les ressources disponibles

5. Considérations importantes

• Immutabilité : Les constantes ne pouvez pas ne peuvent pas être modifiées après leur création. Si vous avez besoin d'une valeur susceptible de changer, utilisez une Variable ressource à la place.

• Conventions de nommage : Utilisez des conventions de nommage claires et cohérentes pour vos constantes (par ex., tout en majuscules avec des underscores : MAX_RECORDS).

• Types de données : Choisissez le type de données correct pour votre constante.

• Alternatives : Pour les données sensibles ou les valeurs qui doivent être gérées en dehors du composant (par ex., clés d'API, paramètres spécifiques à l'environnement), envisagez d'utiliser les Custom Metadata Types, les Custom Settings ou les Named Credentials au lieu des constantes.

En résumé

Les ressources constantes dans Avonni Dynamic Components offrent un moyen de gérer efficacement les valeurs fixes, contribuant à des composants plus organisés, lisibles et maintenables. Utilisez-les pour les valeurs par défaut, les configurations et les valeurs qui ne doivent pas changer pendant le cycle de vie du composant.