v26.01: Arbeiten mit Lese-Knoten

Lese-Knoten rufen Daten aus verschiedenen Quellsystemen ab und machen sie den nachgelagerten Knoten im Workflow verfügbar. Die Kategorie Lese-Knoten bietet verschiedene Knotentypen, die jeweils für bestimmte Datenquellen ausgelegt sind.

Verfügbare Lese-Knotentypen

Konfigurationslayout

Der Abschnitt Konfigurationslayout legt fest, welche Dimensionen und Kennzahlen einbezogen und wie diese in der Ausgabe angeordnet werden sollen.

Das Layout besteht aus drei Abschnitten, die zusammen die Struktur der Daten definieren.

Jede Dimension zeigt folgende Kontrollen an: Filter-Symbol (Elementauswahl), Ellipsen-Menu (Optionen Verschieben/Entfernen), Einstellungen (nur Zeilen) und Erweitern/Zuklappen.

v26.03: Liste aktualisieren

Wenn Dimensionen aus einem Layoutabschnitt entfernt werden, werden sie automatisch in die Aktualisierungsliste verschoben. Die Aktualisierungsliste enthalt alle Dimensionen aus der Quelle, die derzeit in den Layout-Bereichen nicht sichtbar sind.

Um Dimensionen wiederherzustellen, wahlen Sie Liste aktualisieren > Dimensionen markieren > wahlen Sie OK.

Note: Jede Dimension aus der Quelle muss zu jedem Zeitpunkt entweder in den Layout-Abschnitten oder in der Aktualisierungsliste erscheinen. Dies gewahrleistet eine vollstandige Definition der Datenstruktur.

v26.05: Konfiguration des Knotens Datei hochladen

Der Knoten Datei hochladen stellt eine dateibasierte Datenquelle fur Workflows bereit. Workflow-Entwickler konfigurieren den Knoten zur Entwurfszeit mit einem zulassigen Dateityp und einer Beispieldatei fur die Vorschau; Anwender stellen die eigentliche Datei zur Laufzeit uber den Dialog Ausfuhren bereit. Der Knoten ubergibt eine Referenz auf eine Datei an einen nachgeschalteten Dateileser-Knoten - er erzeugt selbst keine tabellarische Ausgabe.

v26.07:  Datei hochladen akzeptiert nun sowohl CSV- als auch Excel-Dateien, wodurch Workflows zur Dateiformatkonvertierung entfallen. Benutzer mussen Excel-Dateien vor dem Hochladen nicht mehr in CSV konvertieren.

So konfigurieren Sie einen Knoten zum Hochladen von Dateien:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf + Hinzufugen von Knoten. Das Dialogfeld Hinzufugen von Knoten wird geoffnet.

2. Wahlen Sie im linken Bereich Lesen.

3. Markieren Sie im rechten Bereich Datei hochladen. Der Knoten wird auf der Arbeitsflache angezeigt und das Konfigurationspanel wird geoffnet.

4. Fullen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmaßig Datei hochladen_[n].
   v26.07:  Zulassige Dateitypen	Dropdown-Menu mit CSV und Excel als Markierung. Unterstutzt Excel-Dateien mit einem oder mehreren Blattern.
   Beispieldatei	Wahlen Sie Datei auswahlen, um die Dateiauswahl des Betriebssystems zu offnen und eine reprasentative Datei auszuwahlen. Der Dateiname wird neben der Schaltflache angezeigt (bei zu großer Lange mit drei Punkten abgeschnitten); bevor eine Datei ausgewahlt wird, zeigt das Feld Keine Datei ausgewahlt an. Die Beispieldatei bleibt beim Veroffentlichen oder erneuten Offnen erhalten, wird fur alle Workflow-Benutzer freigegeben (nicht anwenderspezifisch) und wird niemals dem Verlauf Zuvor hochgeladene Dateien hinzugefugt.
   v26.05: Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachster, um die Ausfuhrungsreihenfolge der Knoten zu kontrollieren. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wahlen Sie Veroffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   In der Kopfzeile der Ebene 2 sind zwei zusatzliche Kontrollen verfugbar:

   • Aktualisieren: Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veroffentlichten Layout-Anderungen an, ohne dass eine vollstandige Veroffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationsfenster angezeigt wird, wahrend das schreibgeschutzte Datengitter beibehalten wird.

v26.07: Unterstuzte Dateiformate

Der Knoten Datei hochladen akzeptiert sowohl CSV- als auch Excel-Dateien.

• Zu den CSV-Dateien gehoren standardmaßige kommagetrennte Werte, tabulatorgetrennte Dateien und Dateien mit benutzerdefinierten Trennzeichen (die zur Laufzeit uber die Kontrollen Kodierung und Trennzeichen konfiguriert werden konnen).

• Zu den Excel-Dateien gehoren Excel-Arbeitsmappen (.xlsx) mit einem oder mehreren Blattern.

• Wenn eine Excel-Datei mit mehreren Blattern hochgeladen wird, konnen Sie im Knoten Dateileser das Blatt markieren, das gelesen werden soll.

Beispieldatei vs. Laufzeitdatei

Die Beispieldatei dient ausschließlich der Vorschau zur Entwurfszeit - sie ermoglicht die Konfiguration des nachgeschalteten Dateileser-Knotens anhand einer reprasentativen Dateistruktur. Zur Laufzeit stellen Benutzer die eigentliche Datei uber den Dialog Ausfuhren bereit (siehe Ausfuhren von Workflows mit Datei hochladen). Die Laufzeitdatei kann einen anderen Inhalt als die Beispieldatei haben.

v26.07: Die Beispieldatei und die Laufzeitdatei konnen unterschiedliche Formate haben (z. B. CSV als Beispieldatei und Excel als Laufzeitdatei), solange die Struktur mit der Konfiguration des Dateileser-Knotens kompatibel ist.

Zuvor hochgeladene Dateien

Nachdem ein Workflow mit einem Datei hochladen-Knoten ausgefuhrt wurde, erscheint die Laufzeitdatei im Abschnitt Zuvor hochgeladene Dateien des Knotens, begrenzt auf den angemeldeten Anwender. Die Dateien werden in umgekehrter chronologischer Reihenfolge mit Zeitstempel und Auslosersymbol aufgelistet. Die Beispieldatei wird niemals zu dieser Liste hinzugefugt.

Knoten zum Hochladen mehrerer Dateien

Ein Workflow kann mehrere Datei hochladen-Knoten enthalten. Jeder Knoten ist unabhangig - sein Name, der zulassige Dateityp, die Beispieldatei und der Upload-Verlauf gelten alle nur fur den jeweiligen Knoten. Zur Laufzeit erhalt jeder Knoten einen eigenen Block im Dialogfeld Ausfuhren, und die Schaltflache Ausfuhren ist nur aktiviert, wenn alle Datei hochladen-Knoten eine gultige Datei enthalten.

Verwaltung des Hochladens zur Laufzeit und des Dateiverlaufs

Zur Laufzeit zeigt der Ausfuhren-Dialog fur jeden Datei hochladen-Knoten einen eigenen Abschnitt Datei hochladen an, mit Kontrollen fur Datei auswahlen, Kodierung und Trennzeichen. Die Schaltflache Ausfuhren bleibt deaktiviert, bis jeder Datei hochladen-Knoten eine gultige Datei enthalt. Ein Abschnitt Zuvor hochgeladene Dateien, der auf den angemeldeten Anwender beschrankt ist, listet vergangene Laufzeit-Hochladungen in umgekehrter chronologischer Reihenfolge zu Prufzwecken auf.

v26.07:  Wenn Excel-Dateien hochgeladen werden, erscheint ein Dropdown-Menu zur Auswahl der Blatter, wenn die Datei mehrere Blatter enthalt, sodass Anwender angeben konnen, welches Blatt gelesen werden soll.

Konfiguration des Knotens Dateileser

Der Knoten Dateileser wandelt eine von einem Datei hochladen-Knoten empfangene Datei in einen tabellarischen Datensatz fur die Weiterverarbeitung um.

v26.07: Ab Version 26.07 unterstutzt der Dateileser nun eine separate Konfiguration fur die Position der Kopfzeilen und der Daten, was eine prazise Kontrolle daruber ermoglicht, wo Kopfzeilen und Daten sowohl in Excel- als auch in CSV-Dateien beginnen.

v26.05: 

Voraussetzung

Ein Datei hochladen-Knoten muss bereits im Workflow vorhanden sein. Der Dateileser kann nicht konfiguriert werden, ohne dass ein vorgelagertes Datei hochladen als Quelle vorhanden ist.

So konfigurieren Sie einen Dateileser-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf + Hinzufugen von Knoten. Das Dialogfeld Hinzufugen von Knoten wird geoffnet.

2. Wahlen Sie im linken Bereich Lesen.

3. Markieren Sie Dateileser im rechten Bereich. Der Knoten wird auf der Arbeitsflache angezeigt und das Konfigurationspanel wird geoffnet.

4. Fullen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Die Standardbezeichnung lautet Dateileser_[n].
   Quelle	Markieren Sie einen vorhandenen Datei hochladen-Knoten aus der Dropdown-Liste. Die Dropdown-Liste enthalt alle Datei hochladen-Knoten im Workflow und wird dynamisch aktualisiert, wenn Knoten hinzugefugt, entfernt oder umbenannt werden.
   Startzelle der Kopfzeile v26.07:	Zellbezug, der die Kopfzeile und die Spalten ganz links definiert (z. B. A1 oder B3). Die Zeile der Kopfzeilen-Startzelle wird als Kopfzeile behandelt; die Erkennung der Spalten beginnt bei der angegebenen Spalte. Diese Einstellung ist unabhangig von der Daten-Startzelle, sodass Kopfzeilen und Daten in unterschiedlichen Zeilen beginnen konnen. Note: v26.08: Bei Excel-Dateien konnen Sie eine beliebige gultige Zellreferenz angeben. Bei CSV-Dateien ist die Kopfzeile immer auf die erste Zeile und die erste Spalte festgelegt.
   Startzelle fur die Daten v26.07:	Zelle, die definiert, wo der Datenbereich beginnt (z. B. A2 oder B4). Zeilen oberhalb dieser Zelle werden ubersprungen; die Zeile der Startzelle fur die Daten ist die erste Datenzeile. Diese Einstellung ist unabhangig von der Kopfzeilen-Startzelle und ermoglicht so flexible Layouts fur Dateien mit Metadaten oder mehreren Kopfzeilen. Note: v26.08: Wenn das Dateiformat gewechselt wird (Excel nach CSV), werden sowohl die Kopfzeilen-Startzelle als auch die Daten-Startzelle automatisch auf die Standard-Startposition zuruckgesetzt, wobei eine Warnung angezeigt wird, um Unstimmigkeiten zu vermeiden.
   Spaltenauswahl	Wahlen Sie Alle Spalten (Standard), um jede Spalte ab der Spalte Kopfzeilen-Startzelle einzubeziehen, oder Bestimmte Spalten, um eine Liste mit Kopfzeilennamen sowie Positionsangaben (Spalten A, B, C...) zu offnen und die einzubeziehenden Spalten zu markieren.
   v26.05: Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachster, um die Ausfuhrungsreihenfolge der Knoten zu kontrollieren. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

   Note: v26.08: Nach der Bearbeitung der Kopfzeile oder der Startzelle fur die Daten oder nach dem Wechseln der Dateiformate wird die Schaltflache Aktualisieren angezeigt. Solange die Schaltflache nicht angeklickt wird, bleibt die Liste der Spalten unverandert, wodurch nachgelagerte Zuordnungen erhalten bleiben. Ein Veraltet-Indikator zeigt an, wenn Spalten veraltet sind, und fordert den Anwender auf, die Daten zu aktualisieren.

5. Wahlen Sie Veroffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System uberpruft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer unterhalb der Arbeitsflache an. Die Daten werden im schreibgeschutzten Format angezeigt und sind entsprechend der Konfiguration des Layouts strukturiert.

   In der Kopfzeile der Ebene 2 sind zwei zusatzliche Kontrollen verfugbar:

   • Aktualisieren: Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veroffentlichten Layout-Anderungen an, ohne dass eine vollstandige Veroffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet die Anzeige des Konfigurationsfensters um, wahrend die schreibgeschutzte Datentabelle beibehalten wird.

v26.07: Unabhangige Kontrolle von Kopfzeilen- und Datenposition

Die Zellen fur den Beginn der Kopfzeile und den Beginn der Daten sind nun unabhangig voneinander einstellbar, sodass Sie Dateien mit nicht standardmaßigen Layouts verarbeiten konnen:

• Szenario 1: Datei mit Metadatenzeilen vor den Kopfzeilen

  • Startzelle der Kopfzeile: B5 (Kopfzeilen beginnen in Zeile 5)

  • Startzelle der Daten: B6 (Daten beginnen in Zeile 6)

• Szenario 2: Datei mit mehreren Kopfzeilen

  • Startzelle der Kopfzeile: A1 (erste Kopfzeile)

  • Startzelle der Daten: A3 (Daten beginnen nach der zweiten Kopfzeile in Zeile 3)

• Szenario 3: Datei mit einzuspringenden Spalten am Anfang

  • Startzelle der Kopfzeile: C1 (Kopfzeilen beginnen in Spalte C)

  • Startzelle der Daten: C2 (Daten beginnen in Spalte C, Zeile 2)

Die Spaltenerkennung wird automatisch aktualisiert, sobald Sie die Positionen der Kopfzeile oder der ersten Daten-Zelle andern, wodurch sichergestellt wird, dass nachgelagerte Zuordnungen mit dem neuen Layout synchron bleiben.

Spaltenposition vs. Kopfzeilenname

Alle nachgelagerten Zuordnungen basieren auf der Position der Spalten (Spalte A, B, C...), nicht auf der Kopfzeile. Wenn die Laufzeitdatei eine andere Kopfzeile enthalt als die Beispieldatei (z. B. "Konto", umbenannt in "ACC"), bleibt die Zuordnung intakt, da sie der Position der Spalten folgt. Dateien mit leeren oder fehlenden Kopfzeilen konnen weiterhin uber dieselbe Position gelesen werden.

Ausgabe

Die Ausgabe des Dateilesers ist ein flacher tabellarischer Datensatz (Zeilen x ausgewahlte Spalten). Alle Werte werden als Text gelesen. Nachgelagerte Knoten (Zuordnung, SQL, Write) ubernehmen etwaige Typkonvertierungen.

Fehlerbedingungen

Der Knoten schlagt zur Laufzeit fehl, wenn:

• Die hochgeladene Datei entspricht nicht der Konfiguration von Datei hochladen (z. B. bei einer Nichtubereinstimmung der Trennzeichen).

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

• v26.07: Die Zeile der Kopfzeilen-Startzelle liegt außerhalb der Zeilenanzahl der Datei.

• v26.07: Die Zeile der Daten-Startzelle liegt außerhalb der Zeilenanzahl der Datei.

• Der verbundene Datei hochladen-Knoten wurde geloscht.

Mehrere Dateileser-Knoten

Ein Datei hochladen-Knoten kann mehrere unabhangige Dateileser-Knoten versorgen, von denen jeder uber eigene Konfigurationen fur Kopfzeilen-Startzelle, Daten-Startzelle und Spaltenauswahl verfugt. Wird der Knoten Datei hochladen geloscht, werden alle verbundenen Dateileser-Knoten ungiultig, bis eine neue Datei hochladen-Quelle ausgewahlt wird.

v26.02: Konfiguration des Knotens Remote-Tabelle

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

So konfigurieren Sie einen Remote-Tabelle-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf + Hinzufugen von Knoten. Das Dialogfeld Hinzufugen von Knoten wird geoffnet.

2. Wahlen Sie im linken Bereich Lesen.

3. Wahlen Sie Remote-Tabelle im rechten Bereich. Der Knoten wird auf der Arbeitsflache angezeigt und das Konfigurationspanel wird geoffnet.

4. Fullen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardname: Remote-Tabelle_[n].
   Quelle	Wahlen Sie eine Remote-Tabelle uber die Inline-Auswahl aus. Alle Dimensionen aus der ausgewahlten Remote-Tabelle werden automatisch zu Zeilen hinzugefugt.
   Layout	Konfigurieren Sie die Abschnitte Zeilen und Filter (kein Abschnitt Spalten).
   v26.05: Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachster, um die Ausfuhrungsreihenfolge der Knoten zu kontrollieren. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wahlen Sie Veroffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System uberpruft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer an. Die Daten werden im schreibgeschutzten Format angezeigt und sind entsprechend der Konfiguration des Layouts strukturiert.

   In der Kopfzeile der Ebene 2 sind zwei zusatzliche Kontrollen verfugbar:

   • Aktualisieren: Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veroffentlichten Layout-Anderungen an, ohne dass eine vollstandige Veroffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationsfenster angezeigt wird, wahrend das schreibgeschutzte Datengitter beibehalten wird.

v26.04: Alle Dimensionen aus der ausgewahlten Remote-Tabelle werden bei der Quellenauswahl automatisch zu Zeilen hinzugefugt. Dimensionen aus Remote-Tabellen weisen keine hierarchischen Beziehungen auf. Remote-Tabelle-Lese-Knoten unterstutzen Workflow-Parameterverweise fur die dynamische Datenfilterung.

Konfiguration des Blatt-Knotens

Blatt-Knoten rufen Daten aus Blattern innerhalb des Arbeitsbereichs ab.

So konfigurieren Sie einen Blatt-Knoten:

1. Klicken Sie auf + Hinzufugen von Knoten. Das Dialogfeld Hinzufugen von Knoten wird geoffnet.

2. Wahlen Sie im linken Bereich Lesen.

3. Wahlen Sie Blatt im rechten Bereich. Der Knoten wird auf der Arbeitsflache angezeigt und das Konfigurationspanel wird geoffnet.

4. Fullen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmaßig lautet der Name Blatt_[n].
   Untertyp	Schreibgeschutztes Feld, das den ausgewahlten Datentyp anzeigt.
   Quelle	Markieren Sie ein Blatt mithilfe der Inline-Auswahl.
   Layout	Konfigurieren Sie die Abschnitte Zeilen, Spalten und Filter.
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachster, um die Ausfuhrungsreihenfolge der Knoten zu kontrollieren. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wahlen Sie Veroffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System uberpruft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer an. Die Daten werden im schreibgeschutzten Format angezeigt und sind entsprechend der Konfiguration des Layouts strukturiert.

   In der Kopfzeile der Ebene 2 sind zwei zusatzliche Kontrollen verfugbar:

   • Aktualisieren: Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veroffentlichten Layout-Anderungen an, ohne dass eine vollstandige Veroffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationsfenster angezeigt wird, wahrend das schreibgeschutzte Datengitter beibehalten wird.

Note: Blattknoten sind der einzige Lesedatentyp mit einem Spalten-Abschnitt im Layout. Der Abschnitt Spalten unterstutzt Dimensionen und Kennzahlen.

v26.02:  Konfiguration eines Transaktionstabellen-Knotens

Transaktionstabelle-Knoten rufen Daten aus Transaktionstabellen innerhalb des Systems ab.

So konfigurieren Sie einen Transaktionstabellenknoten:

1. Klicken Sie auf + Hinzufugen von Knoten. Das Dialogfeld Hinzufugen von Knoten wird geoffnet.

2. Wahlen Sie im linken Bereich Lesen.

3. Wahlen Sie Transaktionstabelle im rechten Bereich. Der Knoten wird auf der Arbeitsflache angezeigt und das Konfigurationspanel wird geoffnet.

4. Fullen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Bezeichnung
   Name	Eindeutige Kennung. Standardmaßig ist Transaktionstabelle_[n] voreingestellt.
   Quelle	Markieren Sie mithilfe der Inline-Auswahl eine Transaktionstabelle.
   Layout	Konfigurieren Sie die Abschnitte Zeilen und Filter (kein Abschnitt Spalten).
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachster, um die Ausfuhrungsreihenfolge der Knoten zu kontrollieren. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wahlen Sie Veroffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System uberpruft die Konfiguration und zeigt die abgerufenen Daten im Raster-Viewer an. Die Daten werden im schreibgeschutzten Format angezeigt und sind entsprechend der Konfiguration des Layouts strukturiert.

   Nach dem Veroffentlichen sind in der Level-2-Kopfzeile zwei zusatzliche Kontrollen verfugbar:

   • Aktualisieren: Liest die Quelldaten erneut ein und zeigt eine Vorschau der noch nicht veroffentlichten Layout-Anderungen an, ohne dass eine vollstandige Veroffentlichung erforderlich ist.

   • Anzeige-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationsfenster angezeigt wird, wahrend das schreibgeschutzte Datengitter beibehalten wird.