Utiliser les variables et les données du composant

Utilisation des Variables et des Données des Composants

Les composants dynamiques Avonni vous permettent d'accéder facilement à divers types de données pour rendre vos composants réellement dynamiques et réactifs. Cela inclut des Variables globales, vos bouton Ressources (Variables, Constantes, Formules), et Attributs d'autres composants sur votre canevas. Comprendre comment accéder à ces données est essentiel pour créer des interactions et des interfaces puissantes.

Comment accéder aux données : le Sélecteur de ressources

La principale façon d'accéder n'importe quel à ces types de données dans le Concepteur de composants est via le Sélecteur de ressources. Il s'agit de la petite icône (ressemblant souvent à { }, une étiquette ou un symbole de variable) située à côté de nombreuses propriétés dans le panneau Propriétés, des configurations de filtres et des paramètres d'interaction.

Lorsque vous cliquez sur le Sélecteur de ressources, vous verrez généralement des options pour choisir parmi :

Variables globales (commençant généralement par $)
Vos ressources définies (Variables, Constantes, Formules - généralement référencées comme {!YourResourceName})
Attributs de composant (vous permettant de référencer d'autres composants en utilisant @ComponentName.attribute)

Accéder aux Variables globales

Les Variables globales fournissent des informations prêtes à l'emploi sur le contexte dans lequel votre composant s'exécute. Vous les sélectionnez via le Sélecteur de ressources.

Les variables globales clés incluent :

$Api: Fournit des informations liées aux API Salesforce. (Utilisé dans des scénarios avancés).
$Component: Fournit un contexte spécifique au composant dynamique lui-même.
- $Component.record: Lorsque le Nom API de l'objet cible est défini et que le composant se trouve sur un page d'enregistrement, cette variable cruciale contient toutes les données de l'enregistrement courant. Vous accédez aux champs en utilisant la notation par points (par ex., $Component.record.Name, $Component.record.Industry).
- $Component.recordId (ou @recordId via le Sélecteur de ressources) : Lorsque le Nom API de l'objet cible est défini et que le composant se trouve sur un page d'enregistrement, cela fournit directement l'ID de l'enregistrement courant sur 15 ou 18 caractères. Très utile pour les filtres ou pour le passage aux interactions.
$Organization: Fournit des détails sur l'organisation Salesforce actuelle (par ex., $Organization.Id, $Organization.Name).
$Profile: Fournit des détails sur le profil Salesforce de l'utilisateur actuel (par ex., $Profile.Id, $Profile.Name). Utile pour contrôler la visibilité en fonction du profil.
$System: Fournit des informations liées au système (la disponibilité peut varier, vérifiez les contextes spécifiques).
$User: Fournit des détails sur l'utilisateur actuellement connecté.
- Exemples : $User.Id, $User.FirstName, $User.LastName, $User.Email, $User.Username. Utile pour la personnalisation, le filtrage des données ("Mes enregistrements") ou la logique conditionnelle.

Accéder à vos Ressources (Variables, Constantes, Formules)

Vous pouvez facilement utiliser les Variables, Constantes et Formules que vous créez dans le panneau Ressources :

Comment : Cliquez sur le Sélecteur de ressources à côté d'une propriété, d'une valeur de filtre ou d'un champ d'entrée d'interaction. Sélectionnez la Variable, la Constante ou la Formule souhaitée dans la liste.
Syntaxe (affichée) : Le concepteur affichera généralement la référence comme {!YourResourceApiName}.
Cas d'utilisation : Affichage de valeurs calculées, stockage des saisies utilisateur, définition de valeurs par défaut, contrôle de la visibilité, utilisation dans les filtres, passage de données aux interactions.

Accéder aux Attributs d'autres Composants (clé de la réactivité)

C'est ainsi que vous faites interagir les composants de manière dynamique :

Comment : Cliquez sur le Sélecteur de ressources. Choisissez le Attribut du composant .
Sélectionner le composant : Choisissez la autre composant sur votre canevas dont vous souhaitez obtenir les données du.
Sélectionner l'attribut : Choisissez le attribut spécifique de ce composant dont vous avez besoin de la valeur (par ex., .value pour les composants d'entrée, .firstSelectedRow pour les tables de données, activeItemValue pour les onglets).
Syntaxe (affichée) : Le concepteur affichera généralement la référence comme @ComponentApiName.attributeName (par ex., @MyCombobox.value, @AccountsTable.firstSelectedRow.Id).
Cas d'utilisation : Créer des filtres réactifs (filtrer la table de données B en fonction de la sélection dans la table de données A), mettre à jour des composants d'affichage (afficher du texte en fonction d'une sélection dans une combobox), contrôler la visibilité en fonction de l'état d'un autre composant.

Exemples pratiques

Exemple 1 : Afficher le nom de l'utilisateur courant

Ajoutez un Texte .
Dans sa propriété propriété, cliquez sur le sélecteur de ressources.
Sélectionnez Variable globale.
Sélectionnez $User.
Sélectionnez FirstName. (La valeur peut s'afficher comme $User.FirstName).
Ajouter un autre Texte .
Dans sa propriété, utilisez le sélecteur de ressources pour choisir Variable globale > $User > LastName.
Vous pouvez aussi utiliser une formule {!$User.FirstName} & " " & {!$User.LastName}

Exemple 2 : Contrôler la visibilité avec une Combobox

Imaginez que vous avez une combobox qui permet aux utilisateurs de sélectionner un statut (« Actif » ou « Inactif »). Vous voulez afficher un bouton « Réactiver » uniquement lorsque « Inactif » est sélectionné.

Ajouter la Combobox : Ajoutez une Combobox Avonni. Donnez-lui un par le véritable (par ex., StatusSelector). Configurez ses options (Libellé/Valeur : Actif/active, Inactif/inactive).
Ajouter le bouton : Ajoutez un bouton Avonni. Définissez son Étiquette à « Réactiver ».
Définir la visibilité du bouton : Sélectionnez le bouton. Dans la Visible propriété, cliquez sur le sélecteur de ressources :
- Choisissez Attribut du composant.
- Composant : Sélectionnez votre Combobox (StatusSelector).
- Attribut : Sélectionnez valeur.
- Opérateur : Définir sur égal.
- Valeur : Entrez le texte inactive (correspondant à la valeur de l'option de la combobox).

Maintenant, le bouton « Réactiver » n'apparaît que lorsque « Inactif » est sélectionné dans la Combobox.

En résumé

Les composants dynamiques Avonni offrent un accès flexible au contexte global, à vos ressources définies et à l'état des autres composants via le sélecteur de ressources. Maîtriser cela vous permet de créer des interfaces utilisateur hautement dynamiques, interactives et conscientes des données sans code

Mis à jour il y a 7 mois

Ce contenu vous a-t-il été utile ?