v26.01: Arbeiten mit Leseknoten

Leseknoten rufen Daten aus verschiedenen Quellsystemen ab und stellen sie nachgeschalteten Knoten im Arbeitsablauf zur Verfügung. Die Kategorie Lesen bietet verschiedene Knotentypen, die jeweils für bestimmte Datenquellen konzipiert sind.

Verfügbare Leseknoten-Typen

Konfigurationslayout

Im Abschnitt Konfigurationslayout wird festgelegt, welche Dimensionen und Metriken in die Ausgabe aufgenommen und wie sie angeordnet werden sollen.

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

Jede Dimension zeigt Steuerelemente an: Filtersymbol (Mitgliederauswahl), Ellipsis-Menü (Optionen zum Verschieben/Entfernen), Voreinstellungen (nur Zeilen) und Erweitern/Komprimieren.

v26.03: Liste aktualisieren:

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

Um die Maße wiederherzustellen, wählen Sie Liste aktualisieren > Maße prüfen > OK.

Note: Jede Dimension aus der Quelle muss zu jeder Zeit entweder in den Layout-Abschnitten oder in der Aktualisierungsliste erscheinen. Dies gewährleistet eine vollständige Definition der Datenstruktur.

v26.05: Konfigurieren des Dateiupload-Knotens

Der Knoten Datei-Upload bietet eine dateibasierte Datenquelle für Workflows. Workflow-Designer konfigurieren den Knoten zur Entwurfszeit mit einem zulässigen Dateityp und einer Beispieldatei für die Vorschau; die Benutzer geben die tatsächliche Datei zur Laufzeit über das Dialogfeld Ausführen ein. Der Knoten übergibt einen Dateiverweis an einen nachgeschalteten File-Reader-Knoten - er erzeugt keine eigene tabellarische Ausgabe.

So konfigurieren Sie einen Dateiupload-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 die Option Lesen.

3. Wählen Sie im rechten Bereich die Option Datei-Upload. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

4. Füllen Sie die erforderlichen Felder in der Konfigurationsleiste aus:

   Parameter:	Beschreibung
   Name	Eindeutiger Bezeichner. Der Standardwert ist File Upload_[n].
   Erlaubte Dateitypen	Dropdown mit vorgewählter CSV. Die Unterstützung mehrerer Excel-Blätter ist für eine zukünftige Version geplant.
   Musterdatei	Wählen Sie Datei auswählen, um den OS-Dateiauswahldialog zu öffnen und eine repräsentative Datei auszuwählen. Der Dateiname wird neben der Schaltfläche angezeigt (mit einem Auslassungszeichen, wenn er zu lang ist); bevor eine Datei ausgewählt wird, wird im Feld Keine Datei ausgewählt angezeigt. Die Beispieldatei bleibt beim Veröffentlichen oder erneuten Öffnen erhalten, wird für alle Workflow-Benutzer freigegeben (nicht benutzerspezifisch) und wird nie zum Verlauf der zuvor hochgeladenen Dateien hinzugefügt.
   v26.05: Einstellungen (optional)	Konfigurieren Sie Vorgänger- und Nachfolgeknoten, um die Reihenfolge der Knotenausführung zu steuern. Weitere Einzelheiten finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Zwei zusätzliche Steuerelemente sind in der Kopfzeile der Ebene 2 verfügbar:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt unveröffentlichte Layoutänderungen in der Vorschau an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Ansichts-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationspanel angezeigt wird, während das schreibgeschützte Datengitter beibehalten wird.

Beispieldatei vs. Laufzeitdatei

Die Beispieldatei wird nur für die Entwurfszeitvorschau verwendet - sie ermöglicht die Konfiguration des nachgeschalteten File-Reader-Knotens anhand einer repräsentativen Dateistruktur. Zur Laufzeit geben die Benutzer die aktuelle Datei über das Dialogfeld Ausführen (siehe v26.01: Arbeiten mit Leseknoten). Die Laufzeitdatei kann einen anderen Inhalt haben als die Beispieldatei.

Zuvor hochgeladene Dateien

Nachdem ein Workflow mit einem Dateiupload-Knoten ausgeführt wurde, wird die Laufzeitdatei in einem Abschnitt " Zuvor hochgeladene Dateien" auf dem Knoten angezeigt, der auf den angemeldeten Benutzer beschränkt ist. Die Dateien werden in umgekehrter chronologischer Reihenfolge mit Zeitstempel und Auslösersymbol aufgelistet. Die Beispieldatei wird nie in diese Liste aufgenommen.

Mehrere Dateiupload-Knoten

Ein Workflow kann mehrere Datei-Upload-Knoten enthalten. Jeder ist unabhängig - sein Name, der zulässige Dateityp, die Beispieldatei und die Upload-Historie sind alle knotenbezogen. Zur Laufzeit erhält jeder Knoten einen eigenen Block im Dialogfeld Ausführen, und die Schaltfläche Ausführen wird nur aktiviert, wenn alle Datei-Upload-Knoten eine gültige Datei enthalten.

Verwaltung des Laufzeit-Uploads und der Dateihistorie

Zur Laufzeit zeigt das Dialogfeld Ausführen für jeden Datei-Upload-Knoten einen eigenen Abschnitt für Datei-Uploads mit Steuerelementen für Datei auswählen, Kodierung und Trennzeichen an. Die Schaltfläche Ausführen bleibt deaktiviert, bis jeder Dateiupload-Knoten eine gültige Datei enthält. Ein Abschnitt " Zuvor hochgeladene Dateien", der auf den angemeldeten Benutzer beschränkt ist, listet frühere Laufzeit-Uploads in umgekehrter chronologischer Reihenfolge zur Überprüfung auf.

v26.05: Konfigurieren des Dateileseknotens

Der Dateileseknoten analysiert eine von einem Datei-Upload-Knoten empfangene Datei in einen tabellarischen Datensatz für die nachgeschaltete Verwendung.

Voraussetzung:

Im Workflow muss bereits ein Dateiupload-Knoten vorhanden sein. Der Dateireader kann nicht konfiguriert werden, ohne dass ein vorgeschalteter Dateiupload als Quelle vorhanden ist.

So konfigurieren Sie einen Dateireader-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 die Option Lesen.

3. Wählen Sie File Reader im rechten Bereich. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

4. Füllen Sie die erforderlichen Felder in der Konfigurationsleiste aus:

   Parameter:	Beschreibung
   Name	Eindeutiger Bezeichner. Der Standardwert ist File Reader_[n].
   Quelle	Wählen Sie einen vorhandenen Datei-Upload-Knoten aus der Dropdown-Liste. Die Dropdown-Liste enthält alle Dateiupload-Knoten im Workflow und wird dynamisch aktualisiert, wenn Knoten hinzugefügt, entfernt oder umbenannt werden.
   Startzelle	Zellbezug, der die Kopfzeile und die Spalte ganz links definiert (z. B. A1 oder B3[MG2.1]). Die Zeile "Start Cell" wird als Kopfzeile behandelt; die Zeilen darunter sind Daten. Die Spalte " Startzelle " ist die Spalte ganz links, die in der Lesung enthalten ist.
   Spaltenauswahl	Wählen Sie Alle Spalten (Standard), um alle Spalten ab der Spalte Startzelle einzubeziehen, oder Bestimmte Spalten, um eine Checkliste mit Kopfzeilennamen und Positionsbezügen (Spalte A, B, C...) zu öffnen und die einzubeziehenden Spalten auszuwählen.
   v26.05: Einstellungen (optional)	Konfigurieren Sie Vorgänger- und Nachfolgeknoten, um die Reihenfolge der Knotenausführung zu steuern. Weitere Einzelheiten finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System validiert die Konfiguration und zeigt die abgerufenen Daten im Grid-Viewer unterhalb des Canvas an. Die Daten erscheinen in einem schreibgeschützten Format, das entsprechend dem konfigurierten Layout strukturiert ist.

   Zwei zusätzliche Steuerelemente sind in der Kopfzeile der Ebene 2 verfügbar:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt unveröffentlichte Layoutänderungen in der Vorschau an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Ansichts-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationspanel angezeigt wird, während das schreibgeschützte Datengitter beibehalten wird.[MG3.1]

Spaltenposition vs. Überschriftsname

Alle nachgelagerten Zuordnungen basieren auf der Spaltenposition (Spalte A, B, C...), nicht auf dem Namen der Überschrift. Wenn die Laufzeitdatei einen anderen Kopftext hat als die Beispieldatei (z. B. "Konto" umbenannt in "ACC"), bleibt die Zuordnung erhalten, da sie der Spaltenposition folgt. Dateien mit leeren oder fehlenden Kopfzeilen sind durch denselben Positionsbezug weiterhin lesbar.

Ausgabe

Die Ausgabe des File Reader ist ein flacher Tabellendatensatz (Zeilen × ausgewählte Spalten). Alle Werte werden als Text gelesen. Nachgelagerte Knoten (Mapping, SQL, Write) verarbeiten jede Art von Konvertierung.

Versagensbedingungen

Der Knoten schlägt zur Laufzeit fehl, wenn:

• Die hochgeladene Datei stimmt nicht mit der Datei-Upload-Konfiguration überein (z. B. Trennzeichen stimmen nicht überein).

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

• Die Zeile "Start Cell" liegt außerhalb der Zeilenzahl der Datei.

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

Mehrere File-Reader-Knoten

Ein Datei-Upload-Knoten kann mehrere unabhängige Dateireader-Knoten versorgen, jeder mit seiner eigenen Startzellen- und Spaltenauswahl-Konfiguration. Wenn der Datei-Upload-Knoten gelöscht wird, werden alle verbundenen Dateireader-Knoten ungültig, bis eine neue Datei-Upload-Quelle ausgewählt wird.

v26.02: Entfernten Tabellenknoten konfigurieren

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

So konfigurieren Sie einen entfernten Tabellenknoten:

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 die Option Lesen.

3. Wählen Sie im rechten Bereich die Option Remote-Tabelle aus. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

4. Füllen Sie die erforderlichen Felder in der Konfigurationsleiste aus:

   Parameter:	Beschreibung
   Name	Eindeutiger Bezeichner. Der Standardwert ist Remote Table_[n].
   Quelle	Wählen Sie mit dem Inline-Selektor eine entfernte Tabelle aus. Alle Dimensionen aus der ausgewählten entfernten Tabelle werden automatisch zu den Zeilen hinzugefügt.
   Layout	Konfigurieren Sie die Abschnitte " Zeilen" und "Filter" (kein Abschnitt " Spalten" ).
   v26.05: Einstellungen (optional)	Konfigurieren Sie Vorgänger- und Nachfolgeknoten, um die Reihenfolge der Knotenausführung zu steuern. Weitere Einzelheiten finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System validiert die Konfiguration und zeigt die abgerufenen Daten im Grid-Viewer unterhalb des Canvas an. Die Daten erscheinen in einem schreibgeschützten Format, das entsprechend dem konfigurierten Layout strukturiert ist.

   Zwei zusätzliche Steuerelemente sind in der Kopfzeile der Ebene 2 verfügbar:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt unveröffentlichte Layoutänderungen in der Vorschau an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Ansichts-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationspanel angezeigt wird, während das schreibgeschützte Datengitter beibehalten wird.

v26.04: Alle Dimensionen aus der ausgewählten Remote-Tabelle werden bei der Auswahl der Quelle automatisch zu den Zeilen hinzugefügt. Dimensionen von entfernten Tabellen haben keine hierarchischen Beziehungen. Remote-Tabellen-Leseknoten unterstützen Workflow-Parameter-Referenzen für die dynamische Datenfilterung.

Blattknoten konfigurieren

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

So konfigurieren Sie einen Blattknoten:

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

2. Wählen Sie im linken Bereich die Option Lesen.

3. Wählen Sie im rechten Bedienfeld die Option Blatt aus. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

4. Füllen Sie die erforderlichen Felder in der Konfigurationsleiste aus:

   Parameter:	Beschreibung
   Name	Eindeutiger Bezeichner. Der Standardwert ist Sheet_[n].
   Untertyp	Schreibgeschütztes Feld, das den ausgewählten Datentyp anzeigt.
   Quelle	Wählen Sie ein Blatt mit dem Inline-Selektor aus.
   Layout	Konfigurieren Sie die Abschnitte Zeilen, Spalten und Filter.
   v26.05:  Einstellungen (optional)	Konfigurieren Sie Vorgänger- und Nachfolgeknoten, um die Reihenfolge der Knotenausführung zu steuern. Weitere Einzelheiten finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System validiert die Konfiguration und zeigt die abgerufenen Daten im Grid-Viewer unterhalb des Canvas an. Die Daten erscheinen in einem schreibgeschützten Format, das entsprechend dem konfigurierten Layout strukturiert ist.

   Zwei zusätzliche Steuerelemente sind in der Kopfzeile der Ebene 2 verfügbar:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt unveröffentlichte Layoutänderungen in der Vorschau an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Ansichts-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationspanel angezeigt wird, während das schreibgeschützte Datengitter beibehalten wird.

Note: Blattknoten sind der einzige Lesedatentyp mit einem Spaltenabschnitt im Layout. Der Abschnitt " Spalten" unterstützt Dimensionen und Metriken.

v26.02:  Transaktions-Tabellenknoten konfigurieren

Transaktionstabellenknoten rufen Daten aus Transaktionstabellen innerhalb des Systems ab.

So konfigurieren Sie einen Transaktions-Tabellenknoten:

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

2. Wählen Sie im linken Bereich die Option Lesen.

3. Wählen Sie Transaktionstabelle im rechten Bereich. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

4. Füllen Sie die erforderlichen Felder in der Konfigurationsleiste aus:

   Parameter:	Beschreibung
   Name	Eindeutiger Bezeichner. Standardmäßig wird Transaktions-Tabelle_[n] verwendet.
   Quelle	Wählen Sie eine Transaktionstabelle mit dem Inline-Selektor aus.
   Layout	Konfigurieren Sie die Abschnitte " Zeilen" und "Filter" (kein Abschnitt " Spalten" ).
   v26.05:  Einstellungen (optional)	Konfigurieren Sie Vorgänger- und Nachfolgeknoten, um die Reihenfolge der Knotenausführung zu steuern. Weitere Einzelheiten finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

   Das System validiert die Konfiguration und zeigt die abgerufenen Daten im Grid-Viewer unterhalb des Canvas an. Die Daten erscheinen in einem schreibgeschützten Format, das entsprechend dem konfigurierten Layout strukturiert ist.

   Nach der Veröffentlichung werden zwei zusätzliche Steuerelemente in der Kopfzeile der Ebene 2 verfügbar:

   • Aktualisieren Liest die Quelldaten erneut ein und zeigt unveröffentlichte Layoutänderungen in der Vorschau an, ohne dass eine vollständige Veröffentlichung erforderlich ist.

   • Ansichts-/Bearbeitungsmodus: Schaltet um, ob das Konfigurationspanel angezeigt wird, während das schreibgeschützte Datengitter beibehalten wird.