v26.01: Arbeiten mit Schreibknoten

Schreibknoten speichern verarbeitete Daten aus vorgelagerten Knoten an Zielorte und schließen damit die Datenverarbeitungspipeline ab. Schreibknoten fungieren in Workflows als Endknoten, d. h., sie akzeptieren nur Eingangsverbindungen und können keine Ausgaben an nachfolgende Knoten liefern.

Verfügbare Schreibknotentypen

Hinweis: Schreibknoten akzeptieren nur Eingangsverbindungen und können keine Ausgangsverbindungen zu anderen Knoten bereitstellen. Sie fungieren als Endknoten und markieren das Ende der Pfade für den Datenfluss im Workflow.

Konfigurationslayout

Schreibknoten erfordern eine umfassende Konfiguration, um das Ausgabeziel, die Datenstruktur, die Zuordnung der Quelle und das Schreibverhalten zu definieren.

Layout-Definition v26.08: 

Die Layout-Definition legt die Ausgabedaten mit spezifischen Anforderungen für jeden Abschnitt fest.

• „Zeilen" enthält Dimensionen, die als Ausgabespalten dargestellt werden.

• „Spalten" ist nun ausschließlich für Kennzahlen reserviert; Dimensionen können nicht zu „Spalten" hinzugefügt werden, und Kennzahlen können nicht daraus entfernt werden.

• „Filter" enthält Dimensionen, die aus „Zeilen" verschoben wurden, wobei jede den Schreibvorgang auf ein einzelnes Blattelement beschränkt; gefilterte Dimensionen werden sowohl aus der Zuordnungstabelle als auch aus der Ausgabe ausgeschlossen.

Hinweis: Das Markieren von Kennzahlen ist obligatorisch, unabhängig davon, wo Kennzahlen in der Layoutstruktur erscheinen (Zeilen, Spalten oder Filter). Jede Kennzahl darf im gesamten Workflow nur in einem Write-Knoten verwendet werden. Das System überprüft die Eindeutigkeit der Kennzahlen und zeigt einen Fehler an, wenn Duplizierungen erkannt werden.

Feld-Mapping v26.08: 

Der Abschnitt „Feld-Mapping" legt die Zuordnung zwischen den Eingabedaten und der Ausgabestruktur fest. Die Benutzeroberfläche zeigt eine zweispaltige Ansicht an, in der links die Felder der Quelle des Eingabeknotens und rechts die Felder des Ausgabelayouts angezeigt werden.

Anforderungen an die Zuordnung:

• Alle Ausgabefelder müssen Quellfeldern zugeordnet werden.

• Quelle und Ausgabedaten müssen kompatibel sein.

• Das System verhindert inkompatible Zuordnungen (Zeichenkette zu Zahl, Datum zu Zeichenkette usw.).

• Wenn die Quelle mehr Spalten hat als die Ausgabe: aggregiert das System die Daten automatisch.

• Wenn die Ausgabe mehr Spalten enthält als die Quelle: muss der Benutzer das Layout anpassen, um die zusätzlichen Dimensionen in die Filter zu verschieben.

• Für Zielblätter: Die Spalten der Quelle müssen eindeutig sein (keine doppelten Datensätze, für die eine Aggregation nicht-numerischer Felder erforderlich ist).

Optionen für den Schreibmodus

Der Schreibmodus legt fest, wie das System mit vorhandenen Daten im Ziel umgeht.

v26.04: Konfiguration des Knotens „Stammdaten"

Der Knoten Stammdaten schreibt Daten direkt in Stammdatentabellen innerhalb des Arbeitsbereichs.

So konfigurieren Sie einen „Stammdaten"-Knoten:

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

2. Wählen Sie im linken Bereich Schreiben aus.

3. Wählen Sie Stammdaten im rechten Bereich. Der Knoten wird auf der Arbeitsfläche angezeigt und das Panel für die Konfiguration wird geöffnet.

4. Füllen Sie die erforderlichen Felder im Bereich der Konfiguration aus:

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Standardmäßig „Stammdaten_[n]".
   Ziel	Wählen Sie mithilfe des Inline-Selektors (Zum Auswählen klicken) eine Tabelle mit Stammdaten aus.
   Eingabe	Wählen Sie mithilfe des Inline-Selektors einen vorgelagerten Knoten (Lesen oder Transformieren) aus.
   Zuordnungsliste	Ordnen Sie Quellspalten den Spalten der Zieltabelle zu.
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachfolgender, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

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

Hinweis: Der Knoten Stammdaten unterstützt Vorgänge des Einfügens und der Fortschreibung, die automatische Datensynchronisation und die Verwaltung von Dimensionen.

Konfiguration des Knotens „Blatt"

Blatt-Knoten speichern verarbeitete Daten in Blättern innerhalb des Arbeitsbereichs.

So konfigurieren Sie einen Blatt-Knoten:

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

2. Wählen Sie im linken Bereich Schreiben aus.

3. Wählen Sie Blatt im rechten Bereich. Der Knoten wird auf der Arbeitsfläche angezeigt und das Panel für die Konfiguration wird geöffnet.

4. Füllen Sie die erforderlichen Felder im Bereich der Konfiguration aus:

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Standardmäßig lautet der Name „Blatt Write_[n]".
   Ziel	Markieren Sie ein Blatt mithilfe der Inline-Auswahl (Zum Auswählen klicken).
   Eingabe	Wählen Sie mithilfe des Inline-Selektors einen vorgelagerten Knoten (Lesen oder Transformieren) aus.
   Layout	Konfigurieren Sie die Abschnitte Zeilen, Spalten und Filter.
   Zuordnungsliste	Ordnen Sie Zielfelder den Quellen zu.
   Schreiboption	Markieren Sie Überschreiben, Zusammenführen oder Anhängen. Legt fest, wie das System mit vorhandenen Daten im Ziel umgeht.
   „Überschreiben" basierend auf	Nur für den Modus Überschreiben. Konfigurieren Sie Festes Element, Daten der Quelle oder Kontextvariable.
   v26.05: Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachfolgender, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. (Optional) Markieren Sie Test, um die Konfiguration zu überprüfen, ohne Änderungen zu übernehmen, oder Vorschau, um das Daten-Frame anzuzeigen, das geschrieben wird.

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

Hinweis: Blattknoten ist der einzige aktivierte Datentyp zum Schreiben, der für den Produktionsbetrieb zugelassen ist. Die Auswahl einer Kennzahl ist im Layout obligatorisch. Jede Kennzahl kann im gesamten Workflow nur in einem Write-Knoten verwendet werden.

v26.07: Konfiguration des Tabellenknotens

Tabellenknoten schreiben verarbeitete Daten in Transaktionstabellen innerhalb des Systems. Damit ist die vollständige Abdeckung des Schreibpfads gewährleistet – Blätter, Stammdaten und Transaktionstabellen können alle als Schreibziele innerhalb eines einzigen Workflows dienen.

So konfigurieren Sie einen Knoten der Tabelle:

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

2. Wählen Sie im linken Bereich Schreiben aus.

3. Wählen Sie Tabelle im rechten Bereich. Der Knoten wird auf der Arbeitsfläche angezeigt und das Panel für die Konfiguration wird geöffnet.

4. Füllen Sie die erforderlichen Felder im Bereich der Konfiguration aus:

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Standardmäßig lautet der Name „Table_[n]".
   Ziel-Tabelle	Wählen Sie mithilfe der Inline-Auswahl (Zum Auswählen klicken) eine Transaktionstabelle aus. Durch das Auswählen eines Ziels werden die Optionen für die Zuordnung und die Behandlung von Duplikaten neu fortgeschrieben.
   Eingabe	Wählen Sie mithilfe des Inline-Selektors einen vorgelagerten Knoten (Lesen, SQL oder Zuordnung) aus. Akzeptiert eine Eingabe. Durch Ändern der Eingabe werden die Spalten der Quelle in der Zuordnung neu gefüllt.
   Mapping bzw. Zuordnung	Ordnen Sie die Quellspalten des Eingabeknotens den Ziel-Dimensionen und -Kennzahlen zu. Jede Zeile zeigt ein Zielfeld an; wählen Sie ein Quellfeld, Ignorieren (nur lokale Dimensionen und Kennzahlen) oder Fester Wert aus der Dropdown-Liste. Mindestens eine Kennzahl muss einem Feld zugeordnet werden.
   Behandlung doppelter Datensätze	Wählen Sie die Strategie zur Behandlung von Duplikaten. Die Optionen hängen von der Duplikatrichtlinie der Zieltabelle ab.
   v26.08:  Schreiboption	Markieren Sie Überschreiben, Zusammenführen oder Anhängen. Legt fest, wie das System mit vorhandenen Daten im Ziel umgeht.
   v26.08:  „Überschreiben" basierend auf	Nur für den Modus Überschreiben. Wählen Sie Dimensionen aus der Liste der Fortschreibungen; verwenden Sie das Symbol Filter für eine beliebige globale Dimension, um das Überschreiben auf bestimmte Elemente einzuschränken.
   Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorheriger und Nachfolgender, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

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

Der Tabellenknoten unterstützt Schreibvorgänge in die Tabelle mit automatischer Duplikatsbehandlung und vollständiger Audit-Protokollierung. Für jeden Schreibvorgang werden die Datenherkunft und Transaktionsdetails auf Zeilenebene erfasst.

Hinweis: v26.08: Die Verfügbarkeit der Schreiboption hängt von der Duplikatrichtlinie der Zieltabelle ab. „Überschreiben" ist immer verfügbar und ist die Standardeinstellung. „Zusammenführen" ist nur verfügbar, wenn Duplizieren deaktiviert ist. „Anhängen" ist nur verfügbar, wenn Duplizieren aktiviert ist.

Intelligente Duplikatsbehandlung

Wenn Sie eine Zieltabelle markieren, erkennt der Tabellenknoten automatisch die Duplikatrichtlinie der Zieltabelle und schränkt die verfügbaren Optionen zur Duplikatsbehandlung entsprechend ein. Wenn die Zieltabelle das Duplizieren zulässt, ist nur die Option „Alle Datensätze einfügen" verfügbar – alle Quelldatensätze werden als neue Datensätze geschrieben. Wenn die Ziel-Tabelle Duplizierungen deaktiviert hat, bietet der Knoten nur die zulässigen Methoden an: „Letzten Wert beibehalten" (Standard), „Alle Datensätze aggregieren" oder „Duplizierte Datensätze ablehnen". Diese intelligente Erkennung verhindert Konfigurationskonflikte und stellt sicher, dass die Schreibmethode stets mit der Richtlinie der Ziel-Tabelle übereinstimmt.

Schreibausführung mit vollständiger Transparenz

Während der Ausführung bietet der Tabellenknoten vollständige Transparenz hinsichtlich des Schreibvorgangs. Eine Ausgabevorschau zeigt die transformierten Daten nach Anwendung der Methode zum Duplizieren an, sodass Sie das Ergebnis vor dem Commit überprüfen können. Das Audit-Protokoll erfasst den Namen der Transaktionstabelle, die verwendete Methode zur Behandlung von Duplikaten und die Zeilenanzahlen für jeden Pfad (geschrieben/übersprungen/aggregiert/abgelehnt), sodass Sie die Datenintegrität überprüfen und Fehler bei Schreibvorgängen beheben können. Diese detaillierte Transparenz der Ausführung unterstützt Compliance-Anforderungen und schafft Vertrauen in Datenänderungen.

v26.08: Überschreibmodus für Transaktionstabellen

Transaktionstabellen lassen aufgrund ihrer Konzeption doppelte Zeilen zu. Wenn ein Workflow wiederholt ausgeführt wird, sammelt der Knoten „Transaktionstabelle schreiben" ohne Überschreib-Modus bei jedem Durchlauf doppelte Datensätze an. Der Überschreib-Modus verhindert dies, indem er den Datenschnitt, der dem angegebenen Schlüssel der Dimension entspricht, vor dem Schreiben neuer Daten löscht, wodurch der Workflow idempotent wird – wiederholte Ausführungen führen zu identischen Ergebnissen ohne Akkumulation von Zeilen.

Der Überschreibungsschlüssel wird durch die im Abschnitt „Überschreiben basierend auf" ausgewählten Dimensionen definiert:

• Eine markierte globale Dimension beschränkt den gelöschten Ausschnitt auf ihre ausgewählten Elemente. Wenn keine Elemente markiert sind, werden alle Elemente einbezogen.

• Eine markierte lokale Dimension wird auf alle Elemente aufgelöst und schränkt den Ausschnitt nicht ein.

• Dimensionen, die nicht im Schlüssel enthalten sind, werden als Platzhalter behandelt – alle ihre Elemente innerhalb des Datenschnitts werden überschrieben.

Der Überschreibungsschlüssel muss mindestens eine globale Dimension enthalten. Ist der Schlüssel leer oder enthält er nur lokale Dimensionen, wird das Veröffentlichen mit der Warnung „Globale Dimension für Überschreiben erforderlich" blockiert.