DataSet bearbeiten
Im DataSets Editor befinden sich drei Fenster:
- oben links: Übersicht der Stages
- oben rechts: Stages können beschrieben und konfiguriert werden
- unten: Vorschau der Daten, wenn man die jeweilige Stage testet. Außerdem können in einem zweiten Reiter Parameter an das DataSet übergeben werden.
Eine Stage bildet immer das Ergebnis einer Query an einem bestimmten Punkt der DataPipeline ab. Jede Stage hat eine eigene Funktionalität, wie z. B. das Filtern der Daten. Die Stages sind dabei hierarchisch aufgebaut, das heißt wenn Stage 3 von 5 getestet wird, werden nur die Stages 1 bis 3 ausgeführt. Im linken oberen Fenster des DataSets Editor ist eine Übersicht der Stages zu sehen. Folgende Aktionen stehen hier zur Verfügung:
- Plus-Zeichen: Stage hinzugefügen
- Stage testen: Stage testen bzw. ausführen
- Tonne-Icon: Stage löschen
- Außerdem können Stages per Drag and Drop verschoben werden
Jedes DataSet beginnt mit der ersten Stage, in der die Daten aus der Quell-Datenstruktur geladen werden. Danach können beliebig viele Stages hinzugefügt werden.
Im rechten oberen Fenster des DataSets Editor können die Stages beschrieben und konfiguriert werden. Die Beschreibung ist für jede Stage gleich aufgebaut:
Es kann ein Titel sowie eine Beschreibung vergeben werden. Die Konfiguration unterscheidet sich je nach Stage.
Im Folgenden werden die einzelnen Stages und deren Funktionalität erklärt.
In der Filter Stage können die Daten anhand einer oder mehrerer Bedingungen gefiltert werden. Beispielsweise kann man alle großen Bestellungen (Bestellsumme größer 1000 €) herausfiltern.
Folgende Schritte sind nötig, um ein Filter hinzuzufügen:
- Feld auswählen, nach dem gefiltert werden soll
- Filterbedingung mithilfe eines Operators und ggf. eines spezifizierten Wertes definieren
- mit den Buttons rechts kann der Datentyp des Wertes gesteuert werden, die Bedingung geleert oder gelöscht werden
- mit "+und" kann die Filterbedingung weiter geschachtelt werden
- links kann per Klick bestimmt werden, ob es eine "und"- (&) oder eine "oder"-Bedingung (or) ist
- mit "+ und Bedingung" können beliebig viele Bedingungen hinzugefügt werden
Folgende Operatoren stehen innerhalb der Filter Stage zur Verfügung:
Operator | Bedeutung | Beschreibung |
|---|---|---|
== | gleich | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes gleich dem angegebenen Wert ist |
> | größer | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes größer als der angegebene Wert ist |
>= | größer gleich | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes größer oder gleich dem angegebenen Wert ist |
< | kleiner | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes kleiner als der angegebene Wert ist |
<= | kleiner gleich | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes kleiner oder gleich dem angegebenen Wert ist |
!= | ungleich | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes nicht gleich dem angegebenen Wert ist |
IN | enthalten | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes gleich einem beliebigen Wert in der angegebenen Liste ist |
NOT IN | nicht enthalten | Findet alle Datensätze, bei denen der Wert des angegebenen Feldes nicht in der angegebenen Liste enthalten ist oder bei denen das Feld nicht existiert |
EXISTS | existiert | Findet alle Datensätze, bei denen das angegebene Feld existiert, einschließlich der Datensätze, bei denen der Feldwert null ist |
AND | und | |
NOT | ist nicht | |
NOR | | |
OR | oder | |
Ein Join kann verwendet werden, um Daten aus zwei oder mehreren Datenstrukturen zu kombinieren.So können beispielsweise Produktdaten mithilfe der Artikel-ID an die Bestelldaten gejoint werden.
Folgende Schritte sind nötig, um ein Join hinzuzufügen:
- bei „Datenstruktur auswählen“ Datenstruktur auswählen, die gejoint werden soll
- Alias vergeben
- Felder auswählen, die gejoint werden sollen
- unter „Join Bedingung“ Schüsselfelder aus der lokalen Datenstruktur und der externen Datenstruktur auswählen (die beiden Felder sind im Idealfall identische Identifikationsnummer o.ä., wie z. B. eine Artikel-ID)
Die Stage Transformer kann genutzt werden, um Felder aus den Daten benutzerdefiniert zu verändern oder zu kombinieren. Beispielsweise können mithilfe eines Transformers mathematische Berechnungen mit Feldern durchgeführt werden oder auch Texte transformiert werden.
Für die Nutzung eines Transformers sind folgende Schritte nötig:
- Alias für das neue Feld vergeben
- gewünschter Transformer im Dropdown Menü auswählen
- erforderliche Felder füllen
Im unteren Fenster des DataSet Editors ist eine Vorschau aller Daten zu sehen, nachdem eine Stage getestet wurde. Es besteht die Möglichkeit, 15, 25, 50 oder 100 Ergebnisse pro Seite anzeigen zu lassen.
Im Reiter "Parameter" können Parameter für die DataSets vergeben werden.
In der Auflistung ist die Bezeichnung, der Typ und der Wert der definierten Parameter zu sehen. Als Aktionen können Parameter bearbeitet (Stift) und gelöscht (Tonne) werden. Außerdem kann oben links definiert werden, wie viele Ergebnisse pro Seite angezeigt werden sollen.
Über den Button "Parameter hinzufügen" kann ein neuer Parameter hinzugefügt werden:
- Name: Name für den Parameter vergeben
- Typ: Typ des Parameters auswählen:
- Text
- Nummer
- JSON
- Wert: Wert des Parameters vergeben
Ziel der einzelnen Parameter ist es, ein DataSet dynamisch zu gestalten, so dass das Ergebnis des DataSets über Variablen im Workflow beeinflusst werden kann:
- Nutzung um dynamische Filter zu erzeugen, bei denen die Werte, nach denen gefiltert wird, erst im Workflow übergeben werden
- Ein Parameter besteht aus einer Bezeichnung, einem Typ und einem Default-Wert