> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/data-sources/query.md).

# Requête

## Aperçu

La source de données de requête permet aux composants de données Avonni — tels que [**Tableau de données**](/experience-cloud/experience-cloud-fr/tutoriels/components/data-table.md), [**Liste**](/experience-cloud/experience-cloud-fr/experience-components/ax-list.md), [**Galerie**](/experience-cloud/experience-cloud-fr/experience-components/ax-gallery.md), et Carte — de récupérer et d’afficher dynamiquement les données d’enregistrements Salesforce sur les sites Experience Cloud.

Cette source de données est conçue pour les situations où le contenu doit rester synchronisé avec les données Salesforce et réagir dynamiquement aux interactions utilisateur sur la page.

***

## Qu’est-ce que la source de données de requête Avonni ?

La source de données de requête Avonni connecte directement les composants Avonni à **des objets Salesforce** via une requête configurable, similaire dans son concept à SOQL mais construite visuellement.

Dans le contexte d’Experience Cloud, elle permet :

* Récupération dynamique des données à partir des enregistrements Salesforce
* [**Comportement réactif**](/experience-cloud/experience-cloud-fr/premiers-pas/reactive-components.md) entre les composants de la même page

***

## Créer une requête

Les requêtes sont créées **directement depuis un composant Avonni**.

Pour créer une nouvelle requête :

1. Sélectionnez un composant de données Avonni (par exemple, un **Tableau de données** ou **Liste**) dans Experience Builder
2. Dans le panneau des propriétés du composant, ouvrez le **Source de données** section
3. Sélectionnez **Requête** comme source de données
4. Configurez les champs, filtres et options de la requête

***

## Filtrer les données

### Configuration des filtres de requête

Les filtres vous permettent de contrôler quels enregistrements Salesforce sont renvoyés par la requête, de manière similaire à une `clause WHERE` dans SOQL.

Les filtres sont configurés directement dans l’éditeur de requête et s’appliquent à tous les composants utilisant cette requête.

***

### Types de filtres

**Filtres statiques**

Les filtres statiques utilisent des valeurs fixes définies lors de la configuration.

Exemple :

* Champ : `Lieu`
* Opérateur : `égal à`
* Valeur : `New York`

Les filtres statiques ne changent pas sauf si la requête est modifiée.

***

## Requêtes réactives

**Que sont les requêtes réactives ?**

Les requêtes réactives permettent aux composants Avonni sur une page Experience Cloud de se mettre à jour automatiquement en réponse aux interactions utilisateur ou aux changements dans d’autres composants.

Cela permet des pages hautement dynamiques et interactives, sans rechargement de page ni code personnalisé.

<a href="/pages/161a510488337bce96b24345cac421fb29729e62" class="button primary" data-icon="square-info">En savoir plus</a>

***

## Quand utiliser la source de données de requête

Utilisez la source de données de requête lorsque :

* Les données doivent rester synchronisées avec les enregistrements Salesforce
* Le contenu doit réagir aux interactions utilisateur
* Plusieurs composants doivent partager le même jeu de données
* Une logique de filtrage et de regroupement est nécessaire

Pour du contenu statique ou éditorial, envisagez plutôt d’utiliser [**Manuel**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/data-sources/manual.md) ou [**Collection CMS**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/data-sources/cms-collection.md) des sources de données.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/data-sources/query.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
