Mit Hilfe der GAPTEQ-Komponente „Data Source“ ist es möglich, Ergebnisse von Datenbankabfragen temporär zu speichern. Dies ist hilfreich, wenn Daten für die weitere Verwendung im Programmablauf nur gelesen und nicht angezeigt werden müssen.
In diesem Artikel lesen Sie folgende Inhalte:
Komponente Data Source konfigurieren
Datenbankabfragen anstoßen und Ergebnisse speichern
Zugriff auf gespeicherte Datensätze
1. Komponente Data Source konfigurieren
Die GAPTEQ-Komponente ‘Data Source’ liest Datensätze einer Tabelle über einen Data Layer aus und speichert das Ergebnis im Data-Source-Objekt. Gehen Sie folgendermaßen vor:
- Ziehen Sie zunächst die Komponente Data Source in die Page. Die Fußleiste der Page zeigt dann folgendes:
- In den Properties der Komponente hinterlegen Sie die entsprechende Datenquelle (Data Layer).
- Anschließend können Sie für die Abfrage über Data Layer unter den "Data links" die notwendigen Filter definieren.
Tipp! In den "Actions" der Komponente können optional Ereignisse zur Programmsteuerung und Fehlerbehandlung verwendet werden. Folgende Möglichkeiten stehen zur Auswahl:
-
-
loaded – Event wird ausgelöst, wenn Daten erfolgreich geladen wurden.
-
loadStarted – Event wird ausgelöst, wenn das Laden der Daten angestoßen wurde.
-
loadNotFound – Event wird ausgelöst, wenn die Abfrage keine Daten liefert.
-
loadError – Event wird ausgelöst, wenn das Laden der Daten fehlgeschlagen ist
-
2. Datenbankabfrage anstoßen und Ergebnisse speichern
Notiz! Das Einlesen von Daten in ein Data-Source-Objekt kann durch ein beliebiges Ereignis ausgelöst werden, z.B. durch das Klick-Event eines Buttons.
Im „Add action“-Dialog der jeweiligen Komponente werden alle für diese Page definierten Data-Source-Objekte aufgelistet und stellen folgende Aktionen zur Auswahl:
-
-
loadows() – Liest alle Datensätze der Abfrage und speichert sie im Data-Source-Objekt.
-
gotoRow(index) – Selektiert einen Datensatz aus dem Data Source anhand des übergebenen Parameters. Der Index startet bei 0.
-
clearRows() – Löscht den Speicher des Data Source Objekts.
-
loadRow(key) – Laden eines Datensatzes anhand des übergebenen Keys.
-
findRow(key) – Lädt einen Datensatz anhand des übergebenen Keys und leert den Speicher, wenn kein Datensatz gefunden wurde.
-
3. Zugriff auf gespeicherte Datensätze
In unserem Beispiel greifen wir nun auf die gespeicherten Werte des Data-Source-Objekts zu und belegen damit die Parameter eines Link-Buttons.
- Dazu wählen Sie beim „clicked“-Event des Buttons "navigation" und "open (page, parameter)" und hinterlegen eine Page, die Parameter erwartet.
- Unter den Data links kann nun die zuvor konfigurierte Data Source Komponente (dataSource1) unter Data link gewählt und der gewünschte Wert als Parameter festgelegt werden.
