> 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-es/panel-de-propiedades/data-sources/query.md).

# Consulta

## Resumen

La fuente de datos de consulta permite que los componentes de datos de Avonni, como [**Tabla de datos**](/experience-cloud/experience-cloud-es/tutoriales/components/data-table.md), [**Lista**](/experience-cloud/experience-cloud-es/experience-components/ax-list.md), [**Galería**](/experience-cloud/experience-cloud-es/experience-components/ax-gallery.md), y Mapa, recuperen y muestren dinámicamente datos de registros de Salesforce en los sitios de Experience Cloud.

Esta fuente de datos está diseñada para situaciones en las que el contenido debe mantenerse sincronizado con los datos de Salesforce y responder dinámicamente a las interacciones del usuario en la página.

***

## ¿Qué es la fuente de datos de consulta de Avonni?

La fuente de datos de consulta de Avonni conecta los componentes de Avonni directamente con **objetos de Salesforce** mediante una consulta configurable, similar en concepto a SOQL pero creada visualmente.

En un contexto de Experience Cloud, permite:

* Recuperación dinámica de datos de registros de Salesforce
* [**Comportamiento reactivo**](/experience-cloud/experience-cloud-es/primeros-pasos/reactive-components.md) entre componentes en la misma página

***

## Creación de una consulta

Las consultas se crean **directamente desde un componente de Avonni**.

Para crear una nueva consulta:

1. Seleccione un componente de datos de Avonni (por ejemplo, un **Tabla de datos** o **Lista**) en Experience Builder
2. En el panel de propiedades del componente, abra el **Fuente de datos** sección
3. Selecciona **Consulta** como fuente de datos
4. Configure los campos, filtros y opciones de la consulta

***

## Filtrado de datos

### Configuración de filtros de consulta

Los filtros le permiten controlar qué registros de Salesforce devuelve la consulta, de forma similar a una `WHERE` cláusula en SOQL.

Los filtros se configuran directamente en el editor de consultas y se aplican a todos los componentes que usan esa consulta.

***

### Tipos de filtros

**Filtros estáticos**

Los filtros estáticos usan valores fijos definidos en el momento de la configuración.

Ejemplo:

* Campo: `Ubicación`
* Operador: `igual a`
* Valor: `Nueva York`

Los filtros estáticos no cambian a menos que se edite la consulta.

***

## Consultas reactivas

**¿Qué son las consultas reactivas?**

Las consultas reactivas permiten que los componentes de Avonni en una página de Experience Cloud se actualicen automáticamente en respuesta a las interacciones del usuario o a cambios en otros componentes.

Esto permite páginas muy dinámicas e interactivas sin recargas de página ni código personalizado.

<a href="/pages/fdf97b863a029dc2bf43a6a0adbde497a044a468" class="button primary" data-icon="square-info">Más información</a>

***

## Cuándo usar la fuente de datos de consulta

Use la fuente de datos de consulta cuando:

* Los datos deben mantenerse sincronizados con los registros de Salesforce
* El contenido debe reaccionar a las interacciones del usuario
* Varios componentes necesitan compartir el mismo conjunto de datos
* Se requiere lógica de filtrado y agrupación

Para contenido estático o editorial, considere usar [**Manual**](/experience-cloud/experience-cloud-es/panel-de-propiedades/data-sources/manual.md) o [**Colección de CMS**](/experience-cloud/experience-cloud-es/panel-de-propiedades/data-sources/cms-collection.md) fuentes de datos en su lugar.


---

# 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-es/panel-de-propiedades/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.
