v26.01: Arbeiten mit Write Node

Schreibknoten speichern verarbeitete Daten von vorgelagerten Knoten an Zielorten und vervollständigen so die Datenverarbeitungspipeline. Schreibknoten fungieren in Workflows als Endknoten, d. h. sie akzeptieren nur Eingabeverbindungen und können keine Ausgabe an nachfolgende Knoten liefern.

Verfügbare Schreibknoten-Typen

Datentyp	Beschreibung
Blatt	Schreibt Daten auf Blätter, einschließlich Standardblätter und mehrteilige Blätter
v26.04: Stammdaten	Schreibt in Stammdatenentitäten wie Hierarchien und Referenzdaten
Tabelle	Schreibt Daten in Tabellen innerhalb des Systems
Remote-Tabelle	Schreiben von Daten in entfernte Tabellen in externen Systemen
Journal	Schreibt Journaleinträge für Transaktionsdaten

Note: Schreibknoten akzeptieren nur Eingangsverbindungen und können keine Ausgangsverbindungen zu anderen Knoten herstellen. Sie fungieren als Endknoten, die das Ende von Datenflusspfaden im Workflow markieren.

Konfiguration Layout

Schreibknoten erfordern eine umfassende Konfiguration, um Ausgabeziel, Datenstruktur, Quellzuordnung und Schreibverhalten zu definieren.

Layout-Definition

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

Abschnitt .	Erlaubte Elemente	Auswahl der Mitglieder	Zweck
Zeilen	Dimensionen oder Metriken	Dynamisch oder fest	Elemente, die als Zeilen in der Ausgabestruktur erscheinen.
Spalten	Dimensionen oder Metriken	Nur feste Blattknoten (Mehrfachauswahl aktiviert)	Elemente, die als Spalten in der Ausgabestruktur erscheinen. Die Beziehung muss "Aktuelles Mitglied" sein.
Filter	Nur Abmessungen	Nur feste Blattknoten	Definiert die feste Schnittmenge für die Datenbuchung ohne Anzeige in der Ausgabe.

Note: Die Auswahl der Metrik ist obligatorisch, unabhängig davon, wo die Metrik in der Layoutstruktur erscheint (Zeilen, Spalten oder Filter). Jede Metrik kann nur in einem Schreibknoten im gesamten Workflow verwendet werden. Das System prüft die Einzigartigkeit der Metrik und zeigt eine Fehlermeldung an, wenn Duplikate entdeckt werden.

Feldzuordnung:

Der Abschnitt Field Mapping stellt die Korrespondenz zwischen Eingabedaten und Ausgabestruktur her. Die Schnittstelle zeigt eine zweispaltige Ansicht mit Quellfeldern aus dem Eingabeknoten auf der linken Seite und Zielfeldern aus dem Ausgabelayout auf der rechten Seite.

Mapping-Anforderungen:

Alle Zielfelder müssen auf Quellfelder abgebildet werden.
Quell- und Zieldatentypen müssen kompatibel sein.
Das System verhindert inkompatible Zuordnungen (String zu Zahl, Datum zu String usw.).
Wenn die Quelle mehr Spalten hat als das Ziel: Das System aggregiert die Daten automatisch.
Wenn das Ziel mehr Spalten hat als die Quelle: Der Benutzer muss das Layout ändern, um zusätzliche Dimensionen in die Filter zu verschieben.
Für Blattziele: Die Quellspalten müssen eindeutig sein (keine doppelten Datensätze, die eine Aggregation von nicht numerischen Feldern erfordern).

Optionen für den Schreibmodus

Der Schreibmodus bestimmt, wie das System mit den vorhandenen Daten in der Zieldestination umgeht.

Schreibmodus	Verhalten	Anwendungsfall
Überschreiben Sie	Löscht vorhandene Daten auf der Grundlage der angegebenen Kriterien, bevor neue Daten geschrieben werden. Erfordert die Konfiguration der Löschkopfzeile, um anzugeben, welche Daten gelöscht werden sollen.	Vollständige Aktualisierung der Daten, wenn frühere Werte ersetzt werden sollen.
Zusammenführen	Aktualisiert bestehende Datensätze, bei denen die Dimensionskombinationen genau übereinstimmen. Fügt neue Datensätze ein, wenn keine Übereinstimmung besteht. Funktioniert identisch mit dem Verhalten beim Zusammenführen von Dateien.	Inkrementelle Aktualisierungen, bei denen einige Datensätze aktualisiert werden und neue Datensätze hinzugefügt werden.
Anhängen	Fügt Datensätze hinzu, ohne vorhandene Daten zu löschen. Gilt vor allem für Tabellenziele (warteschlangenbasierte Vorgänge). Nicht relevant für Blattziele.	Hinzufügen neuer Datensätze zu bestehenden Daten ohne Änderungen.

Konfiguration des Überschreibmodus

Wenn der Überschreibmodus ausgewählt ist, konfigurieren Sie den Löschkopf, um anzugeben, welche Daten gelöscht werden sollen:

Option	Beschreibung
Festes Element:	Löscht Daten nur für ein bestimmtes Mitglied.
Quelldaten	Verwendet die Werte aus den Eingabedaten, um zu bestimmen, was gelöscht werden soll.
Kontextvariable	Verwendet Workflow-Kontextwerte, um zu bestimmen, was gelöscht werden soll.

v26.04: Konfigurieren von Stammdaten ode

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

So konfigurieren Sie einen Stammdatenknoten:

Klicken Sie in der Kopfzeile der Ebene 2 auf + Knoten hinzufügen. Das Dialogfeld Knoten hinzufügen wird geöffnet.
Wählen Sie im linken Bereich Schreiben.
Wählen Sie im rechten Bereich Stammdaten aus. Der Knoten wird auf der Arbeitsfläche angezeigt, und das seitliche Konfigurationsfenster wird geöffnet.

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

Parameter:	Beschreibung
Name	Eindeutiger Bezeichner. Der Standardwert ist Stammdaten_[n].
Ziel	Wählen Sie eine Stammdatentabelle mit dem Inline-Selektor aus (Zum Auswählen klicken).
Eingabe	Wählen Sie einen vorgelagerten Knoten (Lesen oder Transformieren) mit dem Inline-Selektor aus.
Mapping-Liste	Quellspalten den Spalten der Zieltabelle zuordnen.
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.

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

Note: Der Stammdatenknoten unterstützt Einfüge- und Aktualisierungsvorgänge, die automatische Datensynchronisierung und die Verwaltung von Dimensionsmitgliedern.

Blattknoten konfigurieren

Blattknoten speichern verarbeitete Daten in Blättern innerhalb des Arbeitsbereichs.

So konfigurieren Sie einen Blattknoten:

Klicken Sie in der Kopfzeile der Ebene 2 auf + Knoten hinzufügen. Das Dialogfeld Knoten hinzufügen wird geöffnet.
Wählen Sie im linken Bereich Schreiben.
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.

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

Parameter:	Beschreibung
Name	Eindeutiger Bezeichner. Der Standardwert ist Blatt Write_[n].
Ziel	Wählen Sie ein Blatt mit dem Inline-Selektor aus (Zum Auswählen klicken).
Eingabe	Wählen Sie einen vorgelagerten Knoten (Lesen oder Transformieren) mit dem Inline-Selektor aus.
Layout	Konfigurieren Sie die Abschnitte Zeilen, Spalten und Filter.
Mapping-Liste	Zuordnung von Zielfeldern zu Quellfeldern.
Schreiboption	Wählen Sie Überschreiben, Zusammenführen oder Anhängen. Legt fest, wie das System die im Ziel vorhandenen Daten behandelt.
Setzen Sie Überschreiben basierend auf	Nur für den Überschreibmodus. Konfigurieren Sie Fixed Member, Quelldaten oder Kontextvariable.
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.

(Optional) Wählen Sie Test, um die Konfiguration zu überprüfen, ohne die Änderungen zu übernehmen, oder Vorschau, um den zu schreibenden Datenrahmen anzuzeigen.
Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, um die Konfiguration zu speichern.

Note: Der Blattknoten ist der einzige aktivierte Schreibdatentyp für den Produktionseinsatz. Die Auswahl der Metrik ist in der Layout-Struktur obligatorisch. Jede Metrik kann nur in einem Schreibknoten im gesamten Workflow verwendet werden.

v26.07: Tabellenknoten konfigurieren

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

So konfigurieren Sie einen Tabellenknoten:

Klicken Sie in der Kopfzeile der Ebene 2 auf + Knoten hinzufügen. Das Dialogfeld „Knoten hinzufügen“ wird geöffnet.
Wählen Sie im linken Bereich die Option Schreiben aus.
Wählen Sie im rechten Bereich Tabelle aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

Füllen Sie die Pflichtfelder im Konfigurationsbereich aus:

Parameter	Bezeichnung
Name	Eindeutige Kennung. Standardmäßig lautet der Name „Table_[n]“.
Ziel	Wählen Sie mithilfe des Inline-Selektors (Zum Auswählen anklicken) eine Transaktionstabelle aus. Durch die Auswahl eines Ziels wird die Zuordnungsliste neu gefüllt und die Optionen zur Behandlung von Duplikaten werden aktualisiert.
Eingabe	Wählen Sie mithilfe des Inline-Selektors einen vorgelagerten Knoten (Read, SQL oder Mapping) aus. Akzeptiert eine Eingabe. Durch Ändern der Eingabe werden die Quellspalten in der Zuordnungsliste neu gefüllt.
Zuordnungsliste	Ordnen Sie die Quellspalten des Eingabeknotens den Zieldimensionen und -kennzahlen zu. In jeder Zeile wird ein Zielfeld angezeigt; wählen Sie aus der Dropdown-Liste das Quellfeld, „Ignorieren“ (nur lokale Dimensionen/Kennzahlen) oder „Fester Wert“ aus. Mindestens eine Kennzahl muss einem Quellfeld zugeordnet werden.
Einstellungen (optional)	Konfigurieren Sie die Knoten Vorgänger und Nachfolger, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

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

Der Table-Knoten unterstützt Schreibvorgänge in Tabellen mit automatischer Duplikatsbehandlung und vollständiger Protokollierung. Bei jedem Schreibvorgang werden die Datenherkunft sowie die Transaktionsdetails auf Zeilenebene erfasst.

Intelligente Behandlung von Duplikaten

Wenn Sie eine Zieltabelle auswählen, erkennt der Knoten Tabelle automatisch die Duplikatrichtlinie des Ziels und schränkt die verfügbaren Optionen zur Duplikatsbehandlung entsprechend ein. Wenn das Ziel Duplikate zulässt, steht nur die Option „Alle Datensätze einfügen“ zur Verfügung – alle Quelldatensätze werden als neue Datensätze geschrieben. Wenn das Ziel Duplikate deaktiviert, bietet der Knoten nur die gültigen Methoden an: Letzten Wert beibehalten (Standard), Alle Datensätze aggregieren oder Doppelte Datensätze verwerfen. Diese intelligente Erkennung verhindert Konfigurationsabweichungen und stellt sicher, dass die Schreibmethode stets mit den Richtlinien der Zieltabelle übereinstimmt.

Schreibzugriffe mit vollständiger Transparenz

Während der Ausführung bietet der Table-Knoten vollständige Transparenz hinsichtlich des Schreibvorgangs. Eine Vorschau der Ausgabe zeigt die transformierten Daten nach Anwendung der Methode zur Duplikatsbehandlung an, sodass Sie das Ergebnis vor dem Speichern überprüfen können. Das Prüfprotokoll erfasst den Namen der Transaktionstabelle, die verwendete Methode zur Behandlung von Duplikaten sowie 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 bei der Ausführung unterstützt die Einhaltung von Compliance-Anforderungen und schafft Vertrauen in Datenänderungen.