Requêtes imbriquées

La source de données Avonni Nested Query vous permet de récupérer des données hiérarchiques depuis votre organisation Salesforce—plus précisément, des enregistrements parents et leurs enregistrements enfants associés—en une seule requête. Ceci est idéal pour afficher des données dans des composants comme Avonni Tree, qui nécessite une structure imbriquée.

Actuellement, les requêtes imbriquées ne sont prises en charge que par le Avonni Tree et Avonni Relationship Graph composants.

Concepts clés

Qu'est-ce qu'une requête imbriquée ?

Une requête imbriquée récupère une liste d'enregistrements parents et, pour chaque enregistrement parent, récupère également ses enregistrements enfants associés. Cela crée une structure de données imbriquée reflétant les relations parent-enfant de vos données Salesforce. Cela diffère d'une requête standard, qui récupère une liste plate d'enregistrements.

Quand utiliser les requêtes imbriquées

Utilisez les requêtes imbriquées lorsque vous devez afficher des données hiérarchiques, généralement dans des composants tels que :

Avonni Tree : Le cas d'utilisation principal, car le composant Tree est conçu pour visualiser des données hiérarchiques.
D'autres composants pourraient bénéficier à l'avenir de l'affichage de relations imbriquées.

Gestion des requêtes imbriquées

Remarque importante : mises à jour de la configuration des requêtes imbriquées

Nous améliorons le processus de configuration des requêtes imbriquées pour le rendre encore plus simple. En conséquence, les étapes et options spécifiques décrites sur cette page peuvent différer légèrement de la version la plus récente disponible dans le générateur Avonni Dynamic Components. Cette documentation sera mise à jour prochainement pour refléter ces améliorations une fois entièrement publiées.

Créer une requête imbriquée

Vous pouvez créer une nouvelle requête imbriquée Avonni de deux manières :

Via le bouton Ressources :
1. Cliquez sur l' panneau Ressources bouton (généralement situé dans l'éditeur de page ou le panneau de composants).
2. Sélectionnez l'option pour créer une nouvelle Ressource Nested Query.
Depuis un composant Avonni (par ex., Tree) :
1. Sélectionnez le composant Avonni (par ex., Tree) à connecter à la requête imbriquée.
2. Dans le panneau des propriétés du composant, cherchez un bouton ou un lien libellé «Créer une requête imbriquée" ou la "Nouvelle requête imbriquée». Cliquez dessus.

Modifier une requête imbriquée

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

Depuis le menu Ressources :
1. Cliquez sur l' panneau Ressources bouton.
2. Localisez la requête imbriquée que vous souhaitez modifier dans la liste des ressources.
3. Sélectionnez l'option pour modifier la requête imbriquée (cela peut être un bouton « Modifier », une icône de crayon, ou en cliquant sur le nom de la requête).
Depuis un composant Avonni :
1. Sélectionnez le composant Avonni (par ex., Tree) utilisant actuellement la requête imbriquée.
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 imbriquée (cela peut être un bouton « Modifier », une icône de crayon, ou similaire).

Note importante

La modification d'une requête imbriquée existante affectera tous les composants Avonni de votre projet utilisant cette même requête imbriquée.
Créer une nouvelle version (recommandé) : Si vous souhaitez modifier une requête imbriquée sans affectant d'autres composants, utilisez le «Enregistrer sous» pour créer une nouvel copie de la requête imbriquée. Ensuite, modifiez la dernière copie.

Configuration des requêtes imbriquées

Configurer une requête imbriquée consiste à définir à la fois la requête parent (pour récupérer les enregistrements de niveau supérieur) et la requête enfant (pour récupérer les enregistrements liés pour chaque parent).

Configuration de la requête parent

La requête parent définit les enregistrements de niveau supérieur que vous souhaitez récupérer. Cela ressemble à la configuration d'une requête standard :

. Créez une requête : Sélectionnez l'objet Salesforce pour les enregistrements parents (par ex., Account).
Champs : Choisissez les champs que vous souhaitez récupérer depuis l'objet parent.
Filtres (optionnel) : Ajoutez des filtres pour limiter les enregistrements parents récupérés (par ex., Type égal 'Client' ). Vous pouvez utiliser ici des filtres statiques et réactifs.

Configuration de la requête enfant

La requête enfant définit comment récupérer les enregistrements liés pour chaque l'enregistrement parent.

. Créez une requête : Sélectionnez l'objet Salesforce pour les enregistrements enfants (par ex., Contact).
Champs : Choisissez les champs que vous souhaitez récupérer depuis l'objet enfant.
Champ de relation : De manière cruciale , vous devrez spécifier le champ sur le enfant objet qui le relie au parent objet (par ex., AccountId sur le Contact objet). C'est ainsi que la requête imbriquée sait quels enregistrements enfants appartiennent à quel enregistrement parent.
Filtres (optionnel) : Vous pouvez ajouter des filtres pour affiner davantage les enregistrements enfants récupérés. Vous pouvez même utiliser des filtres réactifs ici, en faisant référence aux attributs de l' parent enregistrement. Par exemple, vous pourriez filtrer les Contacts pour n'afficher que ceux ayant un Statut de 'Actif' pour chaque Compte sélectionné.

Exemple : comptes et contacts

Pour afficher un arbre de Comptes et leurs Contacts associés :

Créez une ressource Nested Query.
Requête parent :
- . Créez une requête : Account
- Champs : Id, Nom (et tout autre champ de Compte que vous souhaitez afficher)
Requête enfant :
- . Créez une requête : Contact
- Champs : Id, Prénom, Nom, Email
- Champ de relation : AccountId (Ceci lie le Contact à son Compte parent)
Connectez la requête imbriquée à un composant Avonni Tree.
Configurez le composant Tree pour afficher les champs souhaités des enregistrements parent (Compte) et enfant (Contact).