DataSets

Zweck

Das DataSets-Element wird verwendet, um Daten aus einer vorkonfigurierten, wiederverwendbaren Abfrage abzurufen. Ein „DataSet“ ist eine gespeicherte Abfrage, die spezifische Informationen aus einer Datenquelle, wie einer Datenbank, abrufen kann, oft mit Parametern zur Filterung der Ergebnisse.

• Dieses Element ermöglicht es Ihnen, Daten innerhalb eines Flows abzurufen, ohne jedes Mal komplexe Abfragen oder API-Aufrufe erstellen zu müssen.

• Es fördert die Wiederverwendbarkeit und trennt Ihre Datenlogik von Ihrem Flow-Workflow.

Anwendungsfälle:

• Abrufen einer Liste aller Benutzer aus einem bestimmten Land.

• Abrufen von Produktdetails basierend auf einer Produkt-ID (SKU).

• Abrufen aller Bestellungen, die innerhalb eines bestimmten Zeitraums getätigt wurden.

---

Praktische Anwendungshinweise

• Zentralisierte Datenabfragen: DataSets ermöglichen es Ihnen, Ihre Datenabfragen an einem Ort zu verwalten. Wenn sich ein Datenbankschema ändert, müssen Sie nur das DataSet aktualisieren, und alle Flows, die es verwenden, nutzen automatisch die neue Logik.

• Parametrisierung ist der Schlüssel: Die wahre Stärke von DataSets liegt in der Verwendung von Parametern. Sie können ein generisches DataSet wie „Bestellungen abrufen“ erstellen und dynamische Eingaben verwenden, um je nach Kontext des Flows nach Status, Datum oder Kunden-ID zu filtern.

• Umgang mit großen Ergebnissen: Verwenden Sie immer die Optionen Limit und Seite, um große Datenmengen zu verwalten. Das Abrufen von Tausenden von Zeilen auf einmal kann die Leistung des Flows negativ beeinflussen.

---

Konfigurationsoptionen

Option	Beschreibung	Eingabeformat	Beispielwert
DataSet	Ein Dropdown-Menü zur Auswahl der vordefinierten DataSet-Abfrage, die Sie ausführen möchten. Das DataSet selbst, einschließlich seiner zugrunde liegenden Abfrage und Parameter, wird in einem separaten Bereich der Plattform erstellt und verwaltet.	Auswahl aus der Liste der in Ihrem Projekt verfügbaren DataSets.	Aktive Benutzer abrufen
Dynamische Eingabeparameter	Nachdem Sie ein DataSet ausgewählt haben, erscheinen die für die Parameter dieser Abfrage erforderlichen Eingabefelder dynamisch im Konfigurationspanel. Diese Felder ermöglichen es Ihnen, Werte bereitzustellen, um die DataSet-Abfrage für diese spezifische Ausführung zu filtern oder zu ändern.	Variiert je nach den im DataSet definierten Parametern (z. B. Textfelder, Zahleneingaben).	–
Limit	Die maximale Anzahl der zurückzugebenden Datensätze. Dies wird für die Paginierung verwendet.	Integer.	100
Seite	Die Seitenzahl der abzurufenden Ergebnisse, die in Verbindung mit Limit verwendet wird. Bei einem Limit von 100 würde beispielsweise Seite 2 die Datensätze 101-200 abrufen.	Integer.	1

---

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Die Eingaben für dieses Element sind die dynamischen Parameter, die nach der Auswahl eines DataSet erscheinen.

• Ausgabe: Das Element erzeugt eine einzige Ausgabevariable namens Ergebnis. Diese Variable enthält die vom DataSet abgerufenen Daten, typischerweise als JSON-Array von Objekten.

---