v26.01:  Arbeiten mit Lese-Knoten

Lese-Knoten rufen Daten aus verschiedenen Quellsystemen ab und stellen diese den nachgelagerten Knoten im Workflow zur Verfügung. Die Kategorie „Read“ bietet verschiedene Knotentypen, die jeweils für bestimmte Datenquellen ausgelegt sind.

Verfügbare Lese-Knotentypen

Konfigurationslayout

Im Abschnitt „Konfigurationslayout“ wird festgelegt, welche Dimensionen und Kennzahlen einbezogen werden sollen und wie diese in der Ausgabe angeordnet werden sollen.

Das Layout besteht aus drei Abschnitten, die gemeinsam die Datenstruktur definieren.

Jede Dimension enthält Steuerelemente: Filtersymbol (Mitgliederauswahl), Menü mit Auslassungspunkten (Optionen zum Verschieben/Entfernen), Einstellungen (nur Zeilen) sowie Ein- und Ausblenden.

v26.03: Liste aktualisieren:

Wenn Dimensionen aus einem Layoutabschnitt entfernt werden, werden sie automatisch in die Aktualisierungsliste verschoben. Die Aktualisierungsliste enthält alle Dimensionen aus der Quelle, die derzeit in den Layoutabschnitten nicht sichtbar sind.

Um die Dimensionen wiederherzustellen, wählen Sie „Liste aktualisieren“ > wählen Sie die Dimensionen > klicken Sie auf „OK“.

Note: {b}Hinweis: {/b}Jede Dimension aus der Quelle muss stets entweder in den Layout-Abschnitten oder in der Aktualisierungsliste enthalten sein. Dadurch wird eine vollständige Definition der Datenstruktur gewährleistet.

v26.05:  Konfiguration des Knotens für den Datei-Upload

Der Knoten „Datei-Upload“ stellt eine dateibasierte Datenquelle für Workflows bereit. Workflow-Entwickler konfigurieren den Knoten zur Entwurfszeit mit einem zulässigen Dateityp und einer Beispieldatei für die Vorschau; die Benutzer geben die eigentliche Datei zur Laufzeit über den Ausführungsdialog ein. Der Knoten übergibt eine Dateireferenz an einen nachgeschalteten „File Reader“-Knoten – er erzeugt selbst keine tabellarische Ausgabe.

v26.07:  Die Datei-Upload-Funktion unterstützt nun sowohl CSV- als auch Excel-Dateien, wodurch Arbeitsabläufe zur Konvertierung von Dateiformaten entfallen. Benutzer müssen Excel-Dateien vor dem Hochladen nicht mehr in das CSV-Format konvertieren.

So konfigurieren Sie einen „Datei-Upload“-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf „+ Knoten hinzufügen “. Das Dialogfeld „Knoten hinzufügen “ wird geöffnet.

2. Wählen Sie im linken Bereich „Lesen“ aus.

3. Wählen Sie im rechten Bereich die Option „Datei hochladen “ aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmäßig lautet der Name „File Upload_[n]“.
   v26.07:  Zulässige Dateiformate	Dropdown-Menü, in dem „CSV“ und „Excel“ bereits ausgewählt sind. Unterstützt Excel-Dateien mit einem oder mehreren Blättern.
   Beispieldatei	Wählen Sie „Datei auswählen“, um die Dateiauswahl des Betriebssystems zu öffnen, und wählen Sie eine repräsentative Datei aus. Der Dateiname wird neben der Schaltfläche angezeigt (bei zu großer Länge mit drei Punkten gekürzt); bevor eine Datei ausgewählt wird, wird in dem Feld „Keine Datei ausgewählt“ angezeigt. Die Beispieldatei bleibt auch nach dem Veröffentlichen oder erneuten Öffnen erhalten, wird allen Workflow-Benutzern zur Verfügung gestellt (nicht benutzerspezifisch) und wird niemals zum Verlauf „Zuvor hochgeladene Dateien“ hinzugefügt.
   v26.05: Einstellungen (optional)	Konfigurieren Sie die Knoten „Vorher“ und „Nachher“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter „Arbeiten mit Node-Einstellungen “.

5. Wählen Sie in der Überschrift der Ebene 2 die Option „Veröffentlichen“ aus, um die Konfiguration zu speichern.

   In der Kopfzeile der Ebene 2 stehen zwei zusätzliche Steuerelemente zur Verfügung:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veröffentlichten Layoutänderungen an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet ein, ob das Konfigurationsfenster angezeigt wird, während die Datentabelle schreibgeschützt bleibt.

v26.07:  Unterstützte Dateiformate

Der Knoten „Datei-Upload“ akzeptiert sowohl CSV- als auch Excel-Dateien.

• Zu den CSV-Dateien gehören Standarddateien mit durch Kommas getrennten Werten, tabulatorgetrennte Dateien sowie Dateien mit benutzerdefinierten Trennzeichen (die zur Laufzeit über die Steuerelemente „Kodierung“ und „Trennzeichen“ konfiguriert werden können).

• Zu den Excel-Dateien gehören Excel-Arbeitsmappen mit einem oder mehreren Arbeitsblättern (.xlsx).

• Beim Hochladen einer Excel-Datei mit mehreren Arbeitsblättern können Sie über den „File Reader“-Knoten auswählen, welches Arbeitsblatt gelesen werden soll.

Beispieldatei vs. Laufzeitdatei

Die Beispieldatei dient ausschließlich der Vorschau zur Entwurfszeit – sie ermöglicht es, den nachgeschalteten „File Reader “-Knoten anhand einer repräsentativen Dateistruktur zu konfigurieren. Zur Laufzeit geben die Benutzer die eigentliche Datei über den Dialog „Ausführen“ an (siehe „Workflows mit Datei-Upload-Knoten ausführen“). Die Laufzeitdatei kann einen anderen Inhalt haben als die Beispieldatei.

v26.07:  Die Beispieldatei und die Laufzeitdatei können unterschiedliche Formate haben (beispielsweise CSV für die Beispieldatei und Excel für die Laufzeitdatei), solange die Struktur mit der Konfiguration des Dateilesers kompatibel ist.

Zuvor hochgeladene Dateien

Nachdem ein Workflow mit einem „Datei-Upload“-Knoten ausgeführt wurde, wird die Laufzeitdatei im Abschnitt „Zuvor hochgeladene Dateien“ des Knotens angezeigt, wobei der Bereich auf den angemeldeten Benutzer beschränkt ist. Die Dateien werden in umgekehrter chronologischer Reihenfolge mit dem Zeitstempel und dem Auslösesymbol aufgelistet. Die Beispieldatei wird niemals zu dieser Liste hinzugefügt.

Knoten für den Upload mehrerer Dateien

Ein Workflow kann mehrere „Datei-Upload “-Knoten enthalten. Jeder Knoten ist eigenständig – sein Name, die zulässigen Dateitypen, die Beispieldatei und der Upload-Verlauf gelten jeweils nur für diesen Knoten. Zur Laufzeit erhält jeder Knoten im Dialogfeld „Ausführen“ einen eigenen Block, und die Schaltfläche „Ausführen“ ist erst dann aktiviert, wenn alle „Datei-Upload“-Knoten eine gültige Datei enthalten.

Verwaltung von Uploads zur Laufzeit und des Dateiverlaufs

Zur Laufzeit zeigt der Dialog „Ausführen“ für jeden Knoten „Datei-Upload“ einen eigenen Abschnitt „Datei-Uploads“ an, der Steuerelemente für „Datei auswählen“, „Kodierung“ und „Trennzeichen“ enthält. Die Schaltfläche „Ausführen“ bleibt deaktiviert, bis jeder Knoten „Datei hochladen “ eine gültige Datei enthält. Im Abschnitt „Zuvor hochgeladene Dateien“, der auf den angemeldeten Benutzer zugeschnitten ist, werden frühere Uploads während der Laufzeit in umgekehrter chronologischer Reihenfolge zu Prüfungszwecken aufgelistet.

v26.07:  Beim Hochladen von Excel-Dateien wird ein Dropdown-Menü zur Auswahl der Arbeitsblätter angezeigt, wenn die Datei mehrere Arbeitsblätter enthält. Dort können Benutzer festlegen, welches Arbeitsblatt gelesen werden soll.

v26.05:  Konfiguration des Dateileser-Knotens

Der „File Reader “-Knoten wandelt eine vom „File Upload “-Knoten empfangene Datei in einen tabellarischen Datensatz um, der für die Weiterverarbeitung zur Verfügung steht.

v26.07:  Ab Version 26.07 unterstützt der Dateireader nun eine getrennte Konfiguration für die Position der Kopfzeilen und der Daten, wodurch sich genau steuern lässt, wo in Excel- und CSV-Dateien die Kopfzeilen und die Daten beginnen.

Voraussetzung:

Im Workflow muss bereits ein „Datei-Upload“-Knoten vorhanden sein. Der Dateileser kann nicht konfiguriert werden, wenn kein vorgelagerter Datei-Upload als Quelle vorhanden ist.

So konfigurieren Sie einen „File Reader“-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf „+ Knoten hinzufügen “. Das Dialogfeld „Knoten hinzufügen “ wird geöffnet.

2. Wählen Sie im linken Bereich „Lesen“ aus.

3. Wählen Sie im rechten Bereich „Dateireader“ aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmäßig „File Reader_[n]“.
   Quelle	Wählen Sie aus der Dropdown-Liste einen vorhandenen „Datei-Upload“-Knoten aus. In der Dropdown-Liste werden alle „Datei-Upload“-Knoten des Workflows aufgelistet; sie wird dynamisch aktualisiert, sobald Knoten hinzugefügt, entfernt oder umbenannt werden.
   Zelle am Anfang der Kopfzeile v26.07:	Zellreferenz, die die Kopfzeile und die Spalte ganz links definiert (zum Beispiel A1 oder B3). Die Zeile mit der „Header Start Cell“-Zelle wird als Kopfzeile behandelt; die Spaltenerkennung beginnt bei der angegebenen Spalte. Diese Einstellung ist unabhängig von der Startzelle für Daten, sodass Kopfzeilen und Daten in unterschiedlichen Zeilen beginnen können.
   Startzelle für Daten v26.07:	Zellreferenz, die angibt, wo der Datenbereich beginnt (zum Beispiel A2 oder B4). Die Zeilen oberhalb dieser Zelle werden übersprungen; die Zeile der Startzelle für die Daten ist die erste Datenzeile. Diese Einstellung ist unabhängig von der „Header-Startzelle“ und ermöglicht so flexible Dateilayouts mit Metadaten oder mehreren Kopfzeilen.
   Spaltenauswahl	Wählen Sie „Alle Spalten“ (Standard), um alle Spalten ab der Spalte „Startzelle“ einzubeziehen, oder „Bestimmte Spalten“, um eine Liste mit Spaltennamen und Positionsangaben (Spalte A, B, C…) zu öffnen und die gewünschten Spalten auszuwählen.
   v26.05: Einstellungen (optional)	Konfigurieren Sie die Knoten „Vorher“ und „Nachher“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter „Arbeiten mit Node-Einstellungen “.

5. Wählen Sie in der Überschrift der Ebene 2 die Option „Veröffentlichen“ aus, um die Konfiguration zu speichern.

   Das System überprüft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer unterhalb der Arbeitsfläche an. Die Daten werden im schreibgeschützten Format angezeigt und sind entsprechend dem konfigurierten Layout strukturiert.

   In der Kopfzeile der Ebene 2 stehen zwei zusätzliche Steuerelemente zur Verfügung:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veröffentlichten Layoutänderungen an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet die Anzeige des Konfigurationsfensters um, während die Datentabelle schreibgeschützt bleibt. [MG3.1]

v26.07:  Unabhängige Steuerung von Kopfzeile und Datenposition

„Startzelle der Kopfzeile“ und „Startzelle der Daten“ sind nun unabhängige Einstellungen, sodass Sie Dateien mit nicht standardmäßigen Layouts bearbeiten können:

• Szenario 1 Datei mit Metadatenzeilen vor den Kopfzeilen

  • Zelle am Anfang der Kopfzeile: B5 (die Kopfzeilen beginnen in Zeile 5)

  • Startzelle für Daten: B6 (die Daten beginnen in Zeile 6)

• Szenario 2 Datei mit mehreren Kopfzeilen

  • Zelle am Anfang der Kopfzeile: A1 (erste Kopfzeile)

  • Startzelle für Daten: A3 (die Daten beginnen nach der zweiten Kopfzeile in Zeile 3)

• Szenario 3 Datei mit führender Spaltenanzahl, die übersprungen werden soll

  • Zelle am Anfang der Kopfzeile: C1 (die Kopfzeilen beginnen in Spalte C)

  • Startzelle für Daten: C2 (die Daten beginnen in Spalte C, Zeile 2)

Die Spaltenerkennung wird automatisch aktualisiert, sobald Sie die Positionen der Kopfzeile oder der ersten Datenzelle ändern, wodurch sichergestellt wird, dass nachgelagerte Zuordnungen mit dem neuen Layout synchron bleiben.

Spaltenposition vs. Kopfzeilenname

Die gesamte nachgelagerte Zuordnung basiert auf der Spaltenposition (Spalte A, B, C…), nicht auf dem Spaltennamen. Wenn die Laufzeitdatei einen anderen Kopftext als die Beispieldatei hat (beispielsweise wurde „Account“ in „ACC“ umbenannt), bleibt die Zuordnung unverändert, da sie sich nach der Spaltenposition richtet. Dateien mit leeren oder fehlenden Kopfzeilen können weiterhin über denselben Positionsverweis gelesen werden.

Ausgabe

Die Ausgabe des Dateilesers ist ein flacher tabellarischer Datensatz (Zeilen × ausgewählte Spalten). Alle Werte werden als Text gelesen. Nachgelagerte Knoten (Mapping, SQL, Write) übernehmen die Typkonvertierung.

Fehlerzustände

Der Knoten schlägt zur Laufzeit fehl, wenn:

• Die hochgeladene Datei entspricht nicht der Konfiguration für den Datei-Upload (z. B. abweichendes Trennzeichen).

• Die hochgeladene Datei ist leer (0 Byte oder kein Inhalt).

• v26.07:  Die Zeile mit der Startzelle der Kopfzeile liegt außerhalb der Zeilenanzahl der Datei.

• v26.07:  Die Zeile mit der Startzelle für die Daten liegt außerhalb der Zeilenanzahl der Datei.

• Der verbundene Knoten „Datei-Upload“ wurde gelöscht.

Mehrere „File Reader“-Knoten

Ein „File Upload “-Knoten kann mehrere unabhängige „File Reader “-Knoten versorgen, von denen jeder über eigene Konfigurationen für „Header Start Cell“, „Data Start Cell“ und „Column Selection“ verfügt. Wird der Knoten „Datei-Upload“ gelöscht, werden alle damit verbundenen „Datei-Leser“-Knoten ungültig, bis eine neue „Datei-Upload“-Quelle ausgewählt wird.

v26.02:  Konfiguration eines Remote-Tabellenknotens

Remote-Tabellenknoten binden externe Daten aus Remote-Tabellenverbindungen in Workflow-Pipelines ein.

So konfigurieren Sie einen „Remote Table“-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf „+ Knoten hinzufügen “. Das Dialogfeld „Knoten hinzufügen “ wird geöffnet.

2. Wählen Sie im linken Bereich „Lesen“ aus.

3. Wählen Sie im rechten Bereich „Remote-Tabelle“ aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmäßig „Remote Table_[n]“.
   Quelle	Wählen Sie mithilfe des Inline-Selektors eine Remote-Tabelle aus. Alle Dimensionen aus der ausgewählten Remote-Tabelle werden automatisch zu „Zeilen“ hinzugefügt.
   Layout	Konfigurieren Sie die Abschnitte „Zeilen“ und „Filter“ (kein Abschnitt „Spalten“ ).
   v26.05: Einstellungen (optional)	Konfigurieren Sie die Knoten „Vorher“ und „Nachher“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter „Arbeiten mit Node-Einstellungen “.

5. Wählen Sie in der Überschrift der Ebene 2 die Option „Veröffentlichen“ aus, um die Konfiguration zu speichern.

   Das System überprüft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer unterhalb der Arbeitsfläche an. Die Daten werden im schreibgeschützten Format angezeigt und sind entsprechend dem konfigurierten Layout strukturiert.

   In der Kopfzeile der Ebene 2 stehen zwei zusätzliche Steuerelemente zur Verfügung:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veröffentlichten Layoutänderungen an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet ein, ob das Konfigurationsfenster angezeigt wird, während die Datentabelle schreibgeschützt bleibt.

v26.04:  Alle Dimensionen aus der ausgewählten Remote-Tabelle werden bei der Quellenauswahl automatisch zu „Zeilen“ hinzugefügt. Die Dimensionen von Remote-Tabellen weisen keine hierarchischen Beziehungen auf. Remote-Table-Read-Knoten unterstützen Workflow-Parameterverweise für die dynamische Datenfilterung.

Konfiguration des Blattknotens

Blattknoten rufen Daten aus Blättern innerhalb des Arbeitsbereichs ab.

So konfigurieren Sie einen „Sheet“-Knoten:

1. Klicken Sie auf „+ Knoten hinzufügen“. Das Dialogfeld „Knoten hinzufügen “ wird geöffnet.

2. Wählen Sie im linken Bereich „Lesen“ aus.

3. Wählen Sie im rechten Bereich „Blatt“ aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmäßig lautet der Name „Sheet_[n]“.
   Subtyp	Schreibgeschütztes Feld, das den ausgewählten Datentyp anzeigt.
   Quelle	Wählen Sie ein Blatt mithilfe des Inline-Selektors aus.
   Layout	Die Abschnitte „Zeilen“, „Spalten“ und „Filter“ konfigurieren.
   v26.05:  Einstellungen (optional)	Konfigurieren Sie die Knoten „Vorher“ und „Nachher“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter „Arbeiten mit Node-Einstellungen “.

5. Wählen Sie in der Überschrift der Ebene 2 die Option „Veröffentlichen“ aus, um die Konfiguration zu speichern.

   Das System überprüft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer unterhalb der Arbeitsfläche an. Die Daten werden im schreibgeschützten Format angezeigt und sind entsprechend dem konfigurierten Layout strukturiert.

   In der Kopfzeile der Ebene 2 stehen zwei zusätzliche Steuerelemente zur Verfügung:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veröffentlichten Layoutänderungen an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet ein, ob das Konfigurationsfenster angezeigt wird, während die Datentabelle schreibgeschützt bleibt.

Note: {b}Hinweis: {/b}Tabellenknoten sind der einzige „Read“-Datentyp, der im Layout über einen Abschnitt „Spalten“ verfügt. Der Abschnitt „Spalten“ unterstützt Dimensionen und Kennzahlen.

v26.02:  Konfigurieren des Transaktionstabellenknotens

Knoten des Typs „Transaktionstabelle“ rufen Daten aus Transaktionstabellen innerhalb des Systems ab.

So konfigurieren Sie einen „Transaction Table“-Knoten:

1. Klicken Sie auf „+ Knoten hinzufügen“. Das Dialogfeld „Knoten hinzufügen “ wird geöffnet.

2. Wählen Sie im linken Bereich „Lesen“ aus.

3. Wählen Sie im rechten Bereich „Transaktionstabelle“ aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmäßig ist dies die Transaktionstabelle „Table_[n]“.
   Quelle	Wählen Sie mithilfe des Inline-Selektors eine Transaktionstabelle aus.
   Layout	Konfigurieren Sie die Abschnitte „Zeilen“ und „Filter“ (kein Abschnitt „Spalten“ ).
   v26.05:  Einstellungen (optional)	Konfigurieren Sie die Knoten „Vorher“ und „Nachher“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter „Arbeiten mit Node-Einstellungen “.

5. Wählen Sie in der Überschrift der Ebene 2 die Option „Veröffentlichen“ aus, um die Konfiguration zu speichern.

   Das System überprüft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer unterhalb der Arbeitsfläche an. Die Daten werden im schreibgeschützten Format angezeigt und sind entsprechend dem konfigurierten Layout strukturiert.

   Nach der Veröffentlichung stehen in der Level-2-Kopfzeile zwei zusätzliche Steuerelemente zur Verfügung:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veröffentlichten Layoutänderungen an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet ein, ob das Konfigurationsfenster angezeigt wird, während die Datentabelle schreibgeschützt bleibt.