> 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-it/pannello-proprieta/data-sources/query.md).
# Query
## Panoramica
La sorgente dati Query consente ai componenti dati Avonni—come [**Tabella dati**](/experience-cloud/experience-cloud-it/tutorial/components/data-table.md), [**Elenco**](/experience-cloud/experience-cloud-it/experience-components/ax-list.md), [**Galleria**](/experience-cloud/experience-cloud-it/experience-components/ax-gallery.md), e Map—di recuperare e visualizzare dinamicamente i dati dei record Salesforce sui siti Experience Cloud.
Questa sorgente dati è progettata per situazioni in cui i contenuti devono rimanere sincronizzati con i dati Salesforce e rispondere dinamicamente alle interazioni dell'utente sulla pagina.
***
## Che cos'è la sorgente dati Query di Avonni?
La sorgente dati Query di Avonni collega i componenti Avonni direttamente a **oggetti Salesforce** tramite una query configurabile, simile concettualmente a SOQL ma creata visivamente.
In un contesto Experience Cloud, consente:
* Recupero dinamico dei dati dai record Salesforce
* [**Comportamento reattivo**](/experience-cloud/experience-cloud-it/per-iniziare/reactive-components.md) tra i componenti nella stessa pagina
***
## Creazione di una query
Le query vengono create **direttamente da un componente Avonni**.
Per creare una nuova query:
1. Seleziona un componente dati Avonni (ad esempio, un **Tabella dati** oppure **Elenco**) in Experience Builder
2. Nel pannello delle proprietà del componente, apri la **Origine dati** sezione
3. Seleziona **Query** come sorgente dati
4. Configura i campi, i filtri e le opzioni della query
***
## Filtraggio dei dati
### Configurazione dei filtri della query
I filtri consentono di controllare quali record Salesforce vengono restituiti dalla query, in modo simile a una `WHERE` clausola in SOQL.
I filtri vengono configurati direttamente nell'editor della query e si applicano a tutti i componenti che utilizzano quella query.
***
### Tipi di filtri
**Filtri statici**
I filtri statici utilizzano valori fissi definiti in fase di configurazione.
Esempio:
* Campo: `Località`
* Operatore: `uguale a`
* Valore: `New York`
I filtri statici non cambiano a meno che la query non venga modificata.
***
## Query reattive
**Che cosa sono le query reattive?**
Le query reattive consentono ai componenti Avonni in una pagina Experience Cloud di aggiornarsi automaticamente in risposta alle interazioni dell'utente o ai cambiamenti in altri componenti.
Ciò consente pagine altamente dinamiche e interattive senza ricaricamenti della pagina o codice personalizzato.
Scopri di più
***
## Quando usare la sorgente dati Query
Usa la sorgente dati Query quando:
* I dati devono rimanere sincronizzati con i record Salesforce
* I contenuti devono reagire alle interazioni dell'utente
* Più componenti devono condividere lo stesso set di dati
* È richiesta una logica di filtraggio e raggruppamento
Per contenuti statici o editoriali, considera l'uso di [**Manuale**](/experience-cloud/experience-cloud-it/pannello-proprieta/data-sources/manual.md) oppure [**CMS Collection**](/experience-cloud/experience-cloud-it/pannello-proprieta/data-sources/cms-collection.md) sorgenti dati invece.
---
# 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-it/pannello-proprieta/data-sources/query.md?ask=&goal=
```
`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.