Variable

Les ressources variables dans Avonni Dynamic Components stockent des données temporairement au sein d'un composant. Elles sont essentielles pour le comportement dynamique, mais présentent des différences clés par rapport aux variables dans Salesforce Flows.

Aperçu

Une Variable est un conteneur nommé contenant une valeur d'un type de données spécifique. Les variables sont utilisées pour :

• Suivre l'état du composant : Représenter l'état actuel (par exemple, développé/réduit, filtre appliqué, indicateurs de visibilité).

• Calculs intermédiaires : Conserver des valeurs temporaires lors des calculs.

• Passage de données : Partager des données entre différentes parties de votre composant, et avec des composants imbriqués (en utilisant Input/Output).

• Logique conditionnelle : Contrôler la visibilité ou déclencher des actions.

• Conserver l'ID d'enregistrement : Conserver un ID d'enregistrement Salesforce.

Créer une Variable

1. Panneau Ressources : Cliquez sur l'icône bouton Ressources bouton.

2. Nouvelle Ressource : Cliquez sur "+" ou "Nouvelle Ressource".

3. Sélectionnez "Variable".

4. Configurer :

   • Nom API : Nom unique et descriptif (par ex., isPanelVisible, selectedAccountId).

   • Description (optionnelle) : Expliquez l'objectif de la variable.

   • Type de données :

     • Booléen : Cet attribut est ou false.

     • Date : Une date.

     • Date/Heure : Une date et une heure.

     • Nombre : Un nombre.

     • Enregistrement : Une référence à un enregistrement Salesforce (généralement l'ID). Utilisez une interaction "On Load" avec "Get Records" pour peupler les données complètes de l'enregistrement avant lorsque le composant s'affiche.

     • Texte : Une chaîne de texte.

   • Autoriser plusieurs valeurs (collection) : Si coché, la variable contient un liste de valeurs (du type de données choisi).

   • Disponibilité en dehors de ce Dynamic Component :

     • Disponible pour l'entrée : Permet à un composant parent composant (ou paramètre d'URL) de définir la valeur de cette variable.

     • Disponible pour la sortie : Permet à un composant parent composant pour lire la valeur de cette variable.

   • Valeur initiale (Optionnelle) : Définissez une valeur par défaut.

Utilisation des Variables

• Affichage des valeurs : Liez les propriétés du composant (comme le propriété) du composant Texte à la variable.

• Propriétés du composant : Liez des propriétés comme Visible ou Désactivé à des variables booléennes.

• Filtres : Utilisez des variables dans les filtres de source de données (par exemple, dans une Query Data Source).

• valeurs de manière appropriée pour vos données. Passez des variables en entrée aux actions, ou capturez la sortie d'une action dans des variables.

• Formules : Utilisez des variables dans les ressources Formula.

Vous sélectionner variables à partir d'une liste dans le Panneau des Propriétés ou la configuration d'interaction ; vous n'écrivez généralement pas de syntaxe spéciale.

Considérations importantes : Persistance des données (ou absence de celle-ci !)

• La modification d'enregistrement réinitialise les variables : Toute interaction qui crée, met à jour, supprime ou upsert un enregistrement Salesforce va réinitialiser toutes les variables du Dynamic Component à leurs valeurs initiales. C'est une différence clé par rapport aux Flows.

• Solutions de contournement pour la persistance : Si vous avez besoin de conserver des valeurs après des modifications d'enregistrement, vous avez quelques options, none dont aucune n'est idéale, mais ce sont des solutions de contournement :

  • Paramètres d'URL : Passez des données dans l'URL. C'est limité et cela peut rendre les URL encombrées.

  • Logique personnalisée (Flows) : Utilisez un Flow pour gérer les mises à jour d'enregistrements et gérer soigneusement la persistance des données au sein du Flow. Ensuite, renvoyez le résultat final au Dynamic Component. C'est l'option la plus robuste, mais aussi la plus complexe.

  • Stockage local (Attention) : Il pourrait être possible d'explorer l'utilisation du stockage local du navigateur (via JavaScript). C'est une technique avancée qui a des limitations et des implications en matière de sécurité.

• Données en lecture seule Pour les données en lecture seule, cela fonctionne parfaitement.

• Interaction au chargement : Chaque fois qu'un enregistrement Salesforce est mis à jour, l'interaction au chargement est déclenchée pour actualiser le contexte.

: La valeur maximale.

Affichage des détails du compte (Au chargement)

1. Créer une variable d'enregistrement : currentAccount (Type : Compte).

2. Ajoutez une interaction "On Load" à votre composant Dynamic Component:

   • Type d'action : Récupérer des enregistrements

   • Nom API de l'objet : Compte

   • ID d'enregistrement : @recordId

   • Champs : Sélectionnez Id, Name, secteur.

   • Variable d'enregistrement : {!currentAccount}

3. Ajoutez des composants Texte et liez leurs propriété propriétés à {!currentAccount.Name}, {!currentAccount.Industry}, etc