Abfrage

Avonni Query Data Source

Die Avonni Query Data Source ermöglicht es Ihnen, Avonni-Komponenten (Data Table, List, Carousel, Map) mit Ihren Salesforce-Daten in App- und Datensatzseiten zu verbinden. Sie bietet eine flexible und effiziente Möglichkeit, Daten abzurufen und anzuzeigen, und gibt Ihnen präzise Kontrolle darüber, was angezeigt wird und wie.

Kernkonzepte

Was ist die Avonni Query Data Source?

Die Avonni Query Data Source ist ein leistungsfähiges Mittel, um Ihre Avonni-Komponenten (wie Data Table, List, Carousel und Map) direkt mit Ihren Salesforce-Daten zu verbinden. Sie bietet eine flexible und effiziente Methode zum Abrufen und Anzeigen von Daten innerhalb Ihrer App- und Datensatzseiten und ermöglicht eine feinkörnige Kontrolle darüber, welche Daten angezeigt werden und wie sie dargestellt sind.

Wiederverwendbare Abfragen

Sie können eine Query als wiederverwendbare Ressource erstellen und dieselbe Abfrage dann in mehreren Avonni-Komponenten innerhalb Ihrer Dynamic Component verwenden. Das fördert Konsistenz und vereinfacht die Wartung.

Verwalten von Abfragen

Erstellen einer Abfrage

Es gibt zwei Möglichkeiten, eine neue Avonni Query zu erstellen:

Über die Schaltfläche Ressourcen: Klicken Sie auf das Ressourcen Schaltfläche und erstellen Sie eine neue Query-Ressource.
Über eine Avonni-Komponente: Wählen Sie die Komponente (z. B. Data Table) und klicken Sie in deren Eigenschaften auf die "Erstelle eine Query"-Schaltfläche

Bearbeiten einer Abfrage

Sie können eine bestehende Avonni Query auf zwei Arten ändern:

Aus dem Ressourcenmenü:
1. Klicken Sie auf das Ressourcen Schaltfläche.
2. Suchen Sie die Query, die Sie bearbeiten möchten, in der Liste der Ressourcen.
3. Wählen Sie die Option zum Bearbeiten der Query, indem Sie auf den Namen der Query klicken.
Über eine Avonni-Komponente:
1. Wählen Sie die Avonni-Komponente (z. B. Data Table, List), die die Query derzeit verwendet.
2. Finden Sie den Abschnitt, der sich auf die Datenquelle oder Abfrage im Eigenschaftsbereich der Komponente bezieht.
3. Suchen Sie nach einer Option, die Query zu bearbeiten (dies ist eine "Bearbeiten"-Schaltfläche).

Wichtiger Hinweis

Das Ändern einer bestehenden Query wirkt sich auf alle Avonni-Komponenten in Ihrem Projekt aus, die dieselbe Query verwenden. Das liegt daran, dass Queries wiederverwendbare Ressourcen sind.

Erstellen einer neuen Version (empfohlen)

Wenn Sie Änderungen an einer Query vornehmen möchten, ohne die andere Komponenten beeinflussen, verwenden Sie die "Speichern unter“ oder „Duplizieren"-Option (falls verfügbar), um eine neuen Kopie der Query zu erstellen. Ändern Sie dann die neueste Kopie.

Daten filtern

Konfigurieren von Query-Filtern

Avonni Dynamic Components ermöglichen es Ihnen, die von Ihren Abfragen abgerufenen Daten zu filtern, ähnlich wie bei der Verwendung einer WHERE Klausel in einer SOQL-Abfrage. Dadurch können Sie steuern, welche Datensätze in Komponenten wie Data Tables, Lists und Maps angezeigt werden.

Arten von Filtern

Statische Filter: Diese Filter verwenden feste Werte. Sie definieren sie direkt im Filterbereich der Abfrage, indem Sie ein Feld, einen Operator und einen spezifischen Wert auswählen (z. B. Ort ist 'New York'). Statische Filter ändern sich nicht automatisch basierend auf Benutzerinteraktionen.
Reaktive Filter: Diese Filter verwenden dynamische Werte, die sich basierend auf Benutzerinteraktionen oder Änderungen in anderen Komponenten ändern. Anstatt einen festen Wert einzugeben, verweisen Sie auf ein Attribut einer anderen Komponente auf der Seite (z. B. @AccountsTable.firstSelectedRow.Id). Dies schafft eine dynamische Verbindung, sodass die Abfrage automatisch aktualisiert wird, sobald sich das referenzierte Attribut ändert. Siehe die [Reactive Queries documentation](Link zur Reactive Queries-Sektion hier einfügen) für weitere Details.

Einrichten eines statischen Filters (Beispiel)

Um Contact-Datensätze abzurufen, bei denen der Ort 'New York' ist:

Konfiguration Wählen Sie die Komponente, die Sie filtern möchten (z. B. eine Data Table, die Contacts anzeigt).
Öffnen Sie das Filterfeld: Öffnen Sie im Eigenschaftsbereich der Komponente den Abschnitt zur Konfiguration der Datenquelle und ihrer Filter.
Fügen Sie eine Filterbedingung hinzu:
- zur Abfrage hinzu: Wählen Sie das Ort Feld (oder das Feld, das die Ortsinformation enthält).
- AccountId Wählen Sie den Operator gleich aus.
- in Geben Sie den Text 'New York' ein (einschließlich der einfachen Anführungszeichen für einen Textwert).

Diese Einrichtung filtert die Komponente so, dass nur Contacts angezeigt werden, bei denen das Ort Feld gleich 'New York' ist

Gruppieren von Filterbedingungen

Sie können komplexere Filter erstellen, indem Sie Bedingungen mit UND Größe ODER Logik gruppieren. Zum Beispiel, um Contacts abzurufen, bei denen der Ort Ort 'New York' ODER 'San Francisco' ist, UND der (Texttyp) hinzu. Status 'Active' ist:

Erstellen Sie eine Gruppe: Verwenden Sie die Gruppierungsfunktion im Filterbereich (in der Regel dargestellt durch Schaltflächen oder Optionen zum Gruppieren von Bedingungen).
Fügen Sie Bedingungen zur Gruppe hinzu:
- Ort ist 'New York'
- Ort ist 'San Francisco'
Gruppenoperator festlegen: Ändern Sie den Operator der erstellten Gruppe in ODER.
Fügen Sie eine weitere Bedingung hinzu (außerhalb der Gruppe):
- Status ist 'Active'
Standardmäßig werden die Bedingung und die Gruppe mit UND aus.

Verfügbare Filteroperatoren

Die Avonni Query Data Source unterstützt eine Reihe von Operatoren zur Erstellung präziser Filter:

Vergleichsoperatoren:
- Operator gleich ( = )
- ungleich ( <> oder != )
- kleiner als ( < )
- größer als ( > )
- kleiner oder gleich ( <= )
- größer oder gleich ( >= )
String-Operatoren:
- enthält
- beginnt mit
- endet mit
Mengenoperatoren:
- Operator:
- nicht in
Logische Operatoren (zum Gruppieren):
- UND
- ODER
- NICHT

Reaktive Abfragen

Einführung in Reaktive Abfragen

Reaktive Abfragen sind eine Kernfunktion der Avonni Dynamic Components und ermöglichen es Ihren Komponenten (wie Data Tables, Lists, Maps usw.), ihre angezeigten Daten automatisch basierend auf Benutzerinteraktionen oder Änderungen in anderen Komponenten zu aktualisieren. Dies schafft ein dynamisches und reaktionsschnelles Benutzererlebnis, ohne manuelle Seitenaktualisierungen zu erfordern. Alle Avonni Dynamic Components sind von Haus aus reaktiv-fähig.

Wie Reaktive Abfragen funktionieren

Reaktive Abfragen in Avonni Dynamic Components aktualisieren automatisch die Daten in einer Komponente (wie einer Data Table, List oder Map) basierend auf Änderungen in anderen Komponenten auf der Seite. Dies wird erreicht, ohne ohne dass komplexe Formeln geschrieben werden müssen. Stattdessen verweisen Sie direkt auf die Attribute anderer Komponenten innerhalb des Filters der Abfrage.

Direkte Attributreferenzierung

Beim Konfigurieren des Filters einer Abfrage können Sie Attribute anderer Komponenten auf der Seite auswählen. Zum Beispiel:

Wenn Sie eine Data Table haben, die Accounts anzeigt (nennen wir sie AccountsTable) und eine andere Data Table, die Contacts anzeigt, können Sie die Abfrage der Contacts-Data-Table so konfigurieren, dass sie basierend auf der ausgewählten Zeile in der AccountsTable.
In der Filterung der Contacts-Data-Table würden Sie das Feld: Feld (oder das relevante Feld, das Contacts mit Accounts verbindet) auswählen.
Für den Filterwert würden Sie direkt auf das Geben Sie den API-Namen Ihres autogestarteten Flows ein. Attribut der ausgewählten Zeile in der AccountsTable. Dies könnte ungefähr so aussehen: @AccountsTable.firstSelectedRow.Id.
Wenn ein Benutzer in der Accounts-Tabelle eine andere Zeile auswählt, ändert sich der Wert aus den Attributen der ausgewählten Zeile dynamisch, wodurch die Contacts-Tabelle reaktiv wird.

Automatische Aktualisierungen

Wann immer sich der Wert des referenzierten Attributs ändert (z. B. wenn eine neue Zeile in der AccountsTableausgewählt wird), wird die Abfrage automatisch erneut ausgeführt und die verbundene Komponente (die Contacts-Data-Table) aktualisiert sich, um die neuen Ergebnisse anzuzeigen.

Zuletzt aktualisiert vor 23 Tagen

War das hilfreich?