Der Abfragegenerator

Mit dem Abfragegenerator können Sie Daten aus Data Service-Entitäten filtern und dabei eine vordefinierte Syntax beachten.

Verwenden des Abfragegenerators

Der Abfragegenerator verwendet die Funktion Fetch(), um Ihre Data Service-Entitäten auszuwerten und zu sortieren.

Als Voraussetzung müssen Sie in Ihrer App auf vorhandene Data Service-Entitäten verweisen. Um den Abfragegenerator zu verwenden, führen Sie die folgenden Schritte aus:

1. Wählen Sie für das gewünschte Steuerelement eine VB-fähige Eigenschaft aus. Sie können diese Eigenschaftstypen anhand des Felds VB-Datenquelle auf der Registerkarte Allgemein identifizieren.
   
2. Wählen Sie Abfragegenerator aus. Dadurch öffnet sich das Fenster für den Abfragegenerator.
3. Wählen Sie die Entität aus, für die Sie die Abfragen erstellen möchten.
4. Klicken Sie auf der Registerkarte Bedingungen auf:

   Option	Beschreibung
   Bedingung hinzufügen	Zum Hinzuzufügen einer einzelnen Bedingung
   Gruppe hinzufügen	Zum Gruppieren mehrerer Bedingungen

   Wenn Sie zwei oder mehr Bedingungen hinzufügen, bewertet die Abfrage Daten basierend auf AND oder OR-Operatoren und gibt sie zurück:

   • AND – Gibt Daten zurück, bei denen alle Bedingungen erfüllt sind

   • OR – Gibt Daten zurück, bei denen eine Bedingung erfüllt ist

5. Wählen Sie das Entitätsfeld aus, aus dem Sie Daten abfragen möchten.
6. Wählen Sie den Auswertungsoperator aus.
7. Geben Sie den Wert für Ihre Bedingung ein. Der Wert muss vom gleichen Typ wie der Feldtyp sein. Verwenden Sie beispielsweise Zeichenfolgen für Textfelder und Integer für Zahlenfelder.
8. Auf der Registerkarte Zusätzliche Einstellungen können Sie Sortierregeln für die abgefragten Daten konfigurieren:

   Option	Beschreibung
   Nach Feld sortieren	Sortiert die abgefragten Daten nach dem ausgewählten Feld
   Aufsteigend sortieren	Bei „true“ werden die abgefragten Daten in aufsteigender Reihenfolge sortiert.

9. Klicken Sie auf Speichern, um Ihre Abfrage zu speichern.

Die Abruffunktion

Der Abfragegenerator verwendet die Funktion Fetch(), um Entitätsdaten abzurufen und zu bearbeiten.

Die Funktion Fetch() hat die folgenden Parameter:

Parameter	Beschreibung
FilterGroup	Eine Gruppe von Filtern im Data Service
PaginationProps	Geben Sie die Seitengröße und die Anzahl der zu überspringenden Datensätze an.
SortOption [] sortOptions	Geben Sie die zu sortierende Spalte und die Sortierreihenfolge an.
string[] selectedFields	Geben Sie die Entitätsfelder an, die zurückgegeben werden sollen.
ExpansionFieldOption[] expansionFieldOptions	Geben Sie an, welche Spalte einer Beziehungsentität erweitert und zurückgegeben werden soll. Apps erlauben Erweiterungen der Ebene eins, d. h., bei einem Beziehungsfeld erwarten die Ausdrücke, dass eine Eigenschaftsebene zugänglich ist. Der Abfragegenerator fügt diese Eigenschaften automatisch hinzu und sind für die Nicht-System-Entitäten obligatorisch.

The FetchOne() function

Während Fetch() ein ListSource<T> zurückgibt, das vom gleichen Typ wie für Listensteuerelemente ist, gibt FetchOne() einen einzelnen Datensatz vom Typ T zurück.

Für die folgenden Szenarien müssen Sie die Funktion Fetch() manuell ändern, um benutzerdefinierte Ergebnisse zu erhalten:

Einfacher Abruf

Ruft die Anzahl der Datensätze für eine Entität ab, z. B. SystemUsers.

Fetch(of SystemUsers)()

Abrufen mit Filterbedingung

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))

Abrufen mit Filterbedingung und Sortierreihenfolge (aufsteigend)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})

Abrufen mit Filterbedingung und Sortierreihenfolge (absteigend)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})

Abrufen mit statischen PaginationProps

Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))

Abrufen mit steuerungsgebundenen PaginationProps

Beispiel für das Steuerelement Raster bearbeiten:

Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))

Abrufen mit Projektion

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})