Der Abfragegenerator

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

Wichtig:

Die Funktionen Fetch, FetchOne, GetChoiceSet und GetChoiceSetValue sind asynchron und unterstützen keine Verkettung.

Um Entitätsdatensätze in einem Steuerelement anzuzeigen, verwenden Sie eine App-Variable und die Regel Wert festlegen . Sie können die Steuerelementdatenquelle auch mithilfe des Abfragegenerators an Ihre Entität binden.

Praktische Beispiele finden Sie unter Verwenden der Abruffunktionen .

Tipp: Um eine Entitätsvariable beim Laden der Seite oder beim Klicken auf die Schaltfläche zu aktualisieren, fügen Sie eine Regel Wert festlegen hinzu. Öffnen Sie den Abfragegenerator in der Regel Wert festlegen und fügen Sie eine Filterbedingung für Aktualisierungszeit <= Now( ) hinzu.

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. Konfigurieren Sie optional Regeln für die abgefragten Daten auf der Registerkarte Zusätzliche Einstellungen .
9. Wählen Sie Speichern aus, um Ihre Abfrage zu speichern.

Weitere Einstellungen

Auf der Registerkarte Zusätzliche Einstellungen können Sie Regeln für die abgefragten Daten konfigurieren.

In der folgenden Tabelle werden die Elemente der Registerkarte Zusätzliche Einstellungen beschrieben.

Element	Beschreibung
Seitenanfangsindex (überspringen)	Ermöglicht es Ihnen, zu definieren, wie viele Datensätze übersprungen werden sollen, bevor Ergebnisse zurückgegeben werden. Wenn Sie beispielsweise 10 eingeben, beginnt die Abfrage ab dem 11. Datensatz. Hinweis: Das Festlegen eines Seitenstartindex kann für die Paginierung bei großen Datasets nützlich sein.
Seitenbegrenzung (oben)	Ermöglicht das Festlegen der maximalen Anzahl der zurückzugebenden Datensätze. Wenn Sie beispielsweise 50 eingeben, gibt die Abfrage die ersten 50 Zeilen zurück. Hinweis: Durch das Festlegen eines Seitenlimits kann die Abfragegröße gesteuert werden.
Sortierfeld hinzufügen	Fügt ein Sortierfeld hinzu, mit dem Sie eine Sortierregel für die abgefragten Daten konfigurieren können. Das Feld Sortieren nach und die Aufsteigende Elemente sortieren werden angezeigt.
Nach Feld sortieren	Ermöglicht Ihnen die Eingabe des Felds, das Sie zum Sortieren der Daten verwenden möchten.
Aufsteigend sortieren	Bei „true“ werden die abgefragten Daten in aufsteigender Reihenfolge sortiert.
Projektion	Ermöglicht Ihnen, ein bestimmtes Feld aus der Entität zu definieren, das nur in der Ergebnismenge enthalten sein soll. Hinweis: Projektion kann verwendet werden, um Ausgabedaten zu vereinfachen. Projektion ist nur verfügbar, wenn der Abfragegenerator über die Regel Wert festlegen geöffnet wird.

Die Abruffunktion

Der Abfragegenerator verwendet die Funktion Fetch() , um Entitätsdaten abzurufen und zu bearbeiten. Die Funktion Fetch() ist asynchron und unterstützt keine Verkettung.

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.

Wie die FunktionFetch() ist die Funktion FetchOne() asynchron und unterstützt keine Verkettung.

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"})