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

# Abfrage

## Übersicht

Die Query-Datenquelle ermöglicht Avonni-Datenkomponenten – wie etwa [**Datentabelle**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/tutorials/components/data-table.md), [**Liste**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-list.md), [**Galerie**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-gallery.md), und Karte –, um Salesforce-Datensatzdaten auf Experience-Cloud-Seiten dynamisch abzurufen und anzuzeigen.

Diese Datenquelle ist für Situationen gedacht, in denen Inhalte mit Salesforce-Daten synchron bleiben und dynamisch auf Benutzerinteraktionen auf der Seite reagieren müssen.

***

## Was ist die Avonni Query-Datenquelle?

Die Avonni Query-Datenquelle verbindet Avonni-Komponenten direkt mit **Salesforce-Objekten** über eine konfigurierbare Abfrage, konzeptionell ähnlich wie SOQL, jedoch visuell erstellt.

Im Kontext von Experience Cloud ermöglicht sie:

* Dynamisches Abrufen von Daten aus Salesforce-Datensätzen
* [**Reaktives Verhalten**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/erste-schritte/reactive-components.md) zwischen Komponenten auf derselben Seite

***

## Eine Abfrage erstellen

Abfragen werden erstellt **direkt aus einer Avonni-Komponente**.

So erstellen Sie eine neue Abfrage:

1. Wählen Sie eine Avonni-Datenkomponente aus (zum Beispiel eine **Datentabelle** oder **Liste**) im Experience Builder
2. Öffnen Sie im Eigenschaftenbereich der Komponente den **Datenquelle** Abschnitt
3. Wählen Sie **Abfrage** als Datenquelle aus
4. Konfigurieren Sie die Abfragefelder, Filter und Optionen

***

## Berechtigungen

Eine Abfrage wird mit den Berechtigungen der Person ausgeführt, die die Seite aufruft. Der Objektzugriff, die Feldsicherheit und die Freigaberegeln dieses Benutzers bestimmen, welche Datensätze und Felder zurückgegeben werden, und eine Browser-Anfrage kann keinen höheren Zugriff anfordern, als der Benutzer hat.

Auf einer öffentlichen Site sind Besucher, die nicht angemeldet sind, Gastbenutzer, daher laufen ihre Abfragen mit dem Zugriff des Gastbenutzerprofils. Wenn eine Liste für Besucher leer bleibt, für angemeldete Benutzer jedoch gefüllt ist, prüfen Sie, was das Gastbenutzerprofil lesen kann.

Beim Erstellen einer Seite ergeben sich zwei Dinge:

* Zwei Benutzer können aus derselben Abfrage unterschiedliche Ergebnisse sehen. Ein Vertriebsleiter sieht möglicherweise jede Opportunity in einer Datentabelle, während ein Partnerbenutzer nur die mit ihm geteilten sieht.
* Eine Abfrage kann keine benutzerdefinierte Einstellung lesen, einschließlich der geschützten Einstellungen installierter Pakete. Verwenden Sie ein benutzerdefiniertes Objekt, wenn eine Komponente Konfigurationsdaten anzeigen muss.

***

## Daten filtern

### Abfragefilter konfigurieren

Filter ermöglichen es Ihnen zu steuern, welche Salesforce-Datensätze von der Abfrage zurückgegeben werden, ähnlich wie eine `WHERE` Klausel in SOQL.

Filter werden direkt im Abfrage-Editor konfiguriert und gelten für alle Komponenten, die diese Abfrage verwenden.

***

### Filtertypen

**Statische Filter**

Statische Filter verwenden feste Werte, die zur Konfigurationszeit definiert werden.

Beispiel:

* Feld: `Ort`
* Operator: `ist gleich`
* Wert: `New York`

Statische Filter ändern sich nicht, es sei denn, die Abfrage wird bearbeitet.

***

## Reaktive Abfragen

**Was sind reaktive Abfragen?**

Reaktive Abfragen ermöglichen es Avonni-Komponenten auf einer Experience-Cloud-Seite, sich automatisch als Reaktion auf Benutzerinteraktionen oder Änderungen in anderen Komponenten zu aktualisieren.

Dadurch entstehen hochdynamische, interaktive Seiten ohne Neuladen der Seite oder benutzerdefinierten Code.

<a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/erste-schritte/reactive-components.md" class="button primary" data-icon="square-info">Mehr erfahren</a>

***

## Wann die Query-Datenquelle verwendet werden sollte

Verwenden Sie die Query-Datenquelle, wenn:

* Daten mit Salesforce-Datensätzen synchron bleiben müssen
* Inhalte auf Benutzerinteraktionen reagieren müssen
* Mehrere Komponenten denselben Datensatz gemeinsam nutzen müssen
* Filter- und Gruppierungslogik erforderlich ist

Für statische oder redaktionelle Inhalte sollten Sie erwägen, [**Manuell**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/data-sources/manual.md) oder [**CMS-Sammlung**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/data-sources/cms-collection.md) stattdessen Datenquellen zu verwenden.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/data-sources/query.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
