Requête

Avonni Query Data Source

La source de données Avonni Query vous permet de connecter les composants Avonni (Data Table, List, Carousel, Map) à vos données Salesforce au sein des pages d'application et d'enregistrement. Elle offre un moyen flexible et efficace de récupérer et d'afficher des données, vous donnant un contrôle précis sur ce qui est affiché et comment.

Concepts clés

Qu'est-ce que la source de données Avonni Query ?

La source de données Avonni Query est un moyen puissant de connecter vos composants Avonni (tels que Data Table, List, Carousel et Map) directement à vos données Salesforce. Elle fournit une méthode flexible et efficace pour récupérer et afficher des données dans vos pages d'application et d'enregistrement, vous donnant un contrôle fin sur les données affichées et leur présentation.

Requêtes réutilisables

Vous pouvez créer une requête en tant que ressource réutilisable, puis utiliser cette même requête dans plusieurs composants Avonni au sein de votre composant dynamique. Cela favorise la cohérence et simplifie la maintenance.

Gestion des requêtes

Créer une requête

Il existe deux façons de créer une nouvelle requête Avonni :

Via le bouton Ressources : Cliquez sur l' panneau Ressources bouton et créez une nouvelle Ressource Requête.
Depuis un composant Avonni : Sélectionnez le composant (par exemple, Data Table), et dans ses propriétés, cliquez sur le "Créer une requête" bouton

Modifier une requête

Vous pouvez modifier une requête Avonni existante de deux manières :

Depuis le menu Ressources :
1. Cliquez sur l' panneau Ressources bouton.
2. Localisez la requête que vous souhaitez modifier dans la liste des ressources.
3. Sélectionnez l'option pour modifier la requête en cliquant sur le nom de la requête.
Depuis un composant Avonni :
1. Sélectionnez le composant Avonni (par exemple, Data Table, List) qui utilise actuellement la requête.
2. Trouvez la section liée à la source de données ou à la requête dans le panneau des propriétés du composant.
3. Recherchez une option pour modifier la requête (il s'agit d'un bouton "Modifier").

Note importante

La modification d'une requête existante affectera tous les composants Avonni de votre projet utilisant cette même requête. Cela s'explique par le fait que les requêtes sont des ressources réutilisables.

Créer une nouvelle version (recommandé)

Si vous souhaitez apporter des modifications à une requête sans affectant d'autres composants, utilisez l'option "Enregistrer sous" ou la "Dupliquer" (si disponible) pour créer une nouvel copie de la requête. Ensuite, modifiez la dernière copie.

Filtrer les données

Configuration des filtres de requête

Les composants dynamiques Avonni vous permettent de filtrer les données récupérées par vos requêtes, de manière similaire à l'utilisation d'une CLAUSE WHERE dans une requête SOQL. Cela vous permet de contrôler quels enregistrements sont affichés dans des composants comme les Data Tables, les Lists et les Maps.

Types de filtres

Filtres statiques : Ces filtres utilisent des valeurs fixes. Vous les définissez directement dans le panneau de filtres de la requête en sélectionnant un champ, un opérateur et une valeur spécifique (par exemple, Location égale 'New York'). Les filtres statiques ne changent pas automatiquement en fonction des interactions utilisateur.
Filtres réactifs : Ces filtres utilisent des valeurs dynamiques qui changent en fonction des interactions utilisateur ou des modifications d'autres composants. Au lieu d'entrer une valeur fixe, vous référencez un attribut d'un autre composant sur la page (par exemple, @AccountsTable.firstSelectedRow.Id). Cela crée un lien dynamique, de sorte que la requête se met automatiquement à jour chaque fois que l'attribut référencé change. Consultez la documentation sur les [Requêtes réactives](Insérer le lien vers la section Requêtes réactives ici) pour plus de détails.

Configurer un filtre statique (exemple)

Pour récupérer des enregistrements Contact où la Localisation est 'New York' :

Sélectionner le composant : Choisissez le composant que vous souhaitez filtrer (par exemple, une Data Table affichant des Contacts).
Ouvrir le panneau de filtres : Dans le panneau des propriétés du composant, trouvez et ouvrez la section de configuration de la source de données et de ses filtres.
Ajouter une condition de filtre :
- Champ : Sélectionnez le Localisation champ (ou le champ contenant l'information de localisation).
- Opérateur : Choisissez l' égal opérateur.
- Valeur : Saisissez le texte 'New York' (y compris les guillemets simples pour une valeur texte).

Cette configuration filtrera le composant pour n'afficher que les Contacts où le Localisation champ est égal à 'New York'

Regroupement des conditions de filtre

Vous pouvez créer des filtres plus complexes en regroupant des conditions à l'aide de la logique ET et OU . Par exemple, pour récupérer des Contacts où la Localisation est 'New York' OU 'San Francisco', ET le Statut est 'Actif' :

Créer un groupe : Utilisez la fonctionnalité de regroupement dans le panneau de filtres (généralement représentée par des boutons ou des options pour regrouper des conditions).
Ajouter des conditions au groupe :
- Location égale 'New York'
- Localisation égale 'San Francisco'
Définir l'opérateur du groupe : Changez l'opérateur du groupe créé en OU.
Ajouter une autre condition (en dehors du groupe) :
- Statut égal 'Actif'
Par défaut, la condition et le groupe seront combinés en utilisant ET opérateur.

Opérateurs de filtre disponibles

La source de données Avonni Query prend en charge une gamme d'opérateurs pour créer des filtres précis :

Opérateurs de comparaison :
- égal ( = )
- différent de ( <> ou != )
- inférieur à ( < )
- supérieur à ( > )
- inférieur ou égal à ( <= )
- supérieur ou égal à ( >= )
Opérateurs de chaîne :
- contient
- commence par
- se termine par
Opérateurs d'ensemble:
- dans
- n'est pas dans
Opérateurs logiques (pour le regroupement) :
- ET
- OU
- NON

Requêtes réactives

Introduction aux requêtes réactives

Les requêtes réactives sont une fonctionnalité centrale des composants dynamiques Avonni, permettant à vos composants (comme les Data Tables, Lists, Maps, etc.) de mettre automatiquement à jour les données affichées en fonction des interactions utilisateur ou des modifications d'autres composants. Cela crée une expérience utilisateur dynamique et réactive sans nécessiter de rafraîchissement manuel de la page. Tous les composants dynamiques Avonni sont nativement prêts pour la réactivité.

Comment fonctionnent les requêtes réactives

Les requêtes réactives dans les composants dynamiques Avonni mettent automatiquement à jour les données d'un composant (comme une Data Table, une List ou une Map) en fonction des modifications d'autres composants de la page. Ceci est réalisé sans sans avoir besoin d'écrire des formules complexes. Au lieu de cela, vous référencez directement les attributs des autres composants dans le filtre de la requête.

Référence directe d'attributs

Lors de la configuration du filtre d'une requête, vous pouvez sélectionner des attributs d'autres composants présents sur la page. Par exemple :

Si vous avez une Data Table affichant des comptes (appelons-la AccountsTable) et une autre Data Table affichant des Contacts, vous pouvez configurer la requête de la Data Table des Contacts pour filtrer en fonction de la ligne sélectionnée dans la AccountsTable.
Dans le filtre de la Data Table des Contacts, vous sélectionneriez le AccountId champ (ou le champ pertinent liant les Contacts aux Comptes).
Pour la valeur du filtre, vous référenceriez directement l' Id attribut de la ligne sélectionnée AccountsTabledans la @AccountsTable.firstSelectedRow.Id.
. Cela pourrait ressembler à :

Lorsqu'un utilisateur sélectionne une ligne différente dans la table des comptes, la valeur des attributs de la ligne sélectionnée changera dynamiquement, rendant la table des Contacts réactive.

Mises à jour automatiques AccountsTableChaque fois que la valeur de l'attribut référencé change (par exemple, lorsqu'une nouvelle ligne est sélectionnée dans la

Mis à jour il y a 24 jours

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