v26.01: Verwaltung von Workflows

Die Erstellung eines Workflows umfasst einen strukturierten Prozess von der Erstellung bis zum Ausführen. Dieser Abschnitt führt Sie durch die einzelnen Schritte des Lebenszyklus der Workflow-Entwicklung:

Neuen Workflow erstellen: Legen Sie den Workflow-Container mit Name und Beschreibung an.
Zu den Favoriten hinzufügen: Markieren Sie häufig verwendete Workflows für den schnellen Zugriff.
Workflow-Eigenschaften bearbeiten: Aktualisieren Sie die Metadaten des Workflows nach Bedarf.
Knoten hinzufügen: Erstellen Sie die Datenpipeline, indem Sie Knoten hinzufügen und konfigurieren.
Workflows veröffentlichen: Speichern Sie alle Workflow-Konfigurationen.
Workflows ausführen: Führen Sie den Workflow aus und überwachen Sie die Ergebnisse.

Jeder Schritt baut auf dem vorherigen auf und erstellt so einen vollständigen, ausführbaren Workflow, der Datenoperationen automatisiert.

Einen neuen Workflow erstellen

So erstellen Sie einen Workflow:

Navigieren Sie im Explorer-Bereich zum gewünschten Funktionsbereich.
Klicken Sie auf das Symbol + und wählen Sie Workflow aus den verfügbaren Objekttypen.
Das Fenster „Workflow-Details“ wird auf der rechten Seite geöffnet.
Geben Sie den Namen des Workflows in das Feld Name ein (muss eindeutig sein).
Geben Sie eine Beschreibung in das Feld Beschreibung ein.
Bestätigen Sie den Funktionsbereich über das Dropdown-Menü oder ändern Sie ihn.
Wählen Sie Erstellen aus.

Der Workflow wird im Canvas geöffnet und kann nun gestaltet werden.

Zu den Favoriten hinzufügen

So fügen Sie einen Workflow zu den Favoriten hinzu:

Öffnen Sie den Workflow im Canvas.
Klicken Sie auf das Sternsymbol neben dem Namen des Workflows in der Überschrift der Ebene 2.
Es erscheint ein Popup-Fenster mit dem Titel Zu den Favoriten hinzufügen, in dem Sie Folgendes tun können:
- einen Namen für den Favoriten eingeben.
- Wählen Sie einen Ordner zum Speichern aus.
Wählen Sie HINZUFÜGEN aus, um zu bestätigen, oder ABBRECHEN, um den Vorgang zu beenden.

Nach dem Hinzufügen wird der Workflow im Explorer-Bereich unter „Favoriten“ angezeigt, sodass Sie schnell darauf zugreifen können.

Note: Favoriten sind benutzerspezifisch und bleiben über mehrere Sitzungen hinweg erhalten.

Workflow-Eigenschaften bearbeiten

So bearbeiten Sie Workflow-Eigenschaften:

Suchen Sie den Bereich „Workflow-Details“ an der rechten Seite des Canvases.
Bearbeiten Sie eines der folgenden Felder:
- Name: Ändern Sie die Kennung des Workflows (muss eindeutig bleiben).
- Beschreibung: Aktualisieren Sie die Kontextinformationen.
- Funktionsbereich: Wählen Sie aus der Dropdown-Liste einen anderen Funktionsbereich.
- v26.10: Zugriff auf Arbeitsbereichstabellen zulassen: Wählen Sie diese Option aus, damit die SQL-Skript-Knoten in diesem Workflow Tabellen lesen können, die nicht als Knoteneingaben hinzugefügt wurden. Die Option ist als Standardwert deaktiviert und erfordert Verwaltungsrechte für den Workflow.
Änderungen werden im Bedienfeld sofort wirksam.
Klicken Sie auf Veröffentlichen, um die Änderungen dauerhaft zu speichern.

Knoten hinzufügen

Knoten sind die Bausteine von Workflows, wobei jeder Knoten eine bestimmte Operation in der Datenpipeline ausführt. Knoten werden nach einem einheitlichen Verfahren hinzugefügt, und zwischen den Knoten werden automatisch Verbindungen erstellt, um den Datenfluss darzustellen.

So fügen Sie einen Knoten hinzu:

Wählen Sie in der Kopfzeile der Ebene 2 + Knoten hinzufügen aus.

Das Dialogfeld „Knoten hinzufügen“ wird geöffnet. Der Dialog zeigt links die verfügbaren Knoten-Kategorien und rechts die Knoten-Typen an.
Wählen Sie die entsprechende Kategorie im linken Bereich aus.

Verfügbare Kategorien: Transformieren, Lesen, Schreiben, Regelsatz (aktive Kategorien) und Logisch, Zusammenarbeit (Platzhalter für zukünftige Versionen).
Wählen Sie den erforderlichen Datentyp im rechten Bereich aus.

Der Knoten erscheint am Canvas und der Seitenbereich wird geöffnet. Zwischen dem vorherigen Knoten und dem neuen Knoten wird automatisch eine Verbindung hergestellt.
Das Konfigurationsfenster wird auf der rechten Seite offen.
Konfigurieren Sie die datentyp-spezifischen Felder im Seitenbereich.

Note: Die Felddetails variieren je nach Datentyp – siehe Knotentypen und -kategorien verstehen für die Parameterreferenz pro Datentyp und den entsprechenden Abschnitt zum jeweiligen Datentyp für die Konfigurationsanleitung.
(Optional) Konfigurieren Sie den Abschnitt „Einstellungen“, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Details finden Sie unter Arbeiten mit Knoteneinstellungen.
Wählen Sie Veröffentlichen aus, um die Konfiguration zu speichern.

v26.02: Umbenennen von Knoten

Wenn ein Knoten auf dem Canvas umbenannt wird, aktualisiert das System automatisch den Knotennamen in allen Knotenkonfigurationen, in denen er als Quelle oder Eingabe referenziert wird, in allen SQL-Abfragen in SQL-Skript-Knoten, im Canvas-Anzeigen-Bereich und auf der Workflow-Startseite. Es gelten die Standard-Regeln zur Namensvalidierung.

v26.02: Knoten löschen

Wenn ein Knoten gelöscht wird, entfernt das System ihn aus allen abhängigen Knotenkonfigurationen, löscht alle zugehörigen Verbindungen aus dem Canvas und zeigt Warnungen für alle Knoten an, die dadurch unvollständig werden. Der Name des gelöschten Knotens ist zur Wiederverwendung verfügbar.

Workflows veröffentlichen

Durch das Veröffentlichen werden alle Workflow-Konfigurationen dauerhaft gespeichert. Workflows können in beliebiger Entwicklungsphase veröffentlicht werden, auch bei unvollständigen Knotenkonfigurationen.

So veröffentlichen Sie einen Workflow:

Klicken Sie in der Kopfzeile der Ebene 2 auf Veröffentlichen.
Das System speichert alle Änderungen, darunter:
- Das Layout des Canvas und die Positionen der Knoten.
- Alle Knotenkonfigurationen.
- Alle Verbindungen zwischen den Knoten.
- Beliebig viele Löschungen oder Änderungen.
Es erscheint eine Bestätigungsmeldung.

Note: Es gibt keine Validierung, die das Veröffentlichen blockiert. Workflows können auch mit unvollständigen oder nicht verbundenen Knoten gespeichert werden; es werden jedoch Warnsymbole angezeigt, um Benutzer auf Konfigurationsprobleme hinzuweisen.

Workflows ausführen

Ausführen Sie den Workflow, um Daten zu verarbeiten und Ergebnisse anzuzeigen.

So führen Sie einen Workflow aus:

Stellen Sie sicher, dass alle erforderlichen Knoten konfiguriert und veröffentlicht sind.
Klicken Sie in der Kopfzeile der Ebene 2 auf die Schaltfläche Ausführen.
Die Ausführung beginnt am Startknoten.
Am Knoten werden visuelle Anzeigen eingeblendet:
- Wird verarbeitet: Ladesymbol.
- Erfolgreich: Häkchen.
- Fehler: Fehlersymbol.
Die Schaltfläche „Ausführen“ ist während der Ausführung deaktiviert.

Anmerkung: Die Ausführung folgt allen verbundenen Pfaden vom Startknoten aus. Nicht verbundene Knoten werden während des Ausführens übersprungen.

v26.02: Workflows mit Mitgliederauswahl ausführen

Die Schaltfläche „Ausführen“ öffnet ein Inline-Popup mit dem Titel „Auswahlen“, in dem alle im gesamten Workflow verwendeten eindeutigen Dimensionen (Vereinigung der FAContext-Dimensionen) angezeigt werden, wobei die aktuellen L2-Header-Kontext-Auswahlen bereits vorausgefüllt sind.

So führen Sie einen Workflow mit Elementauswahl aus:

Wählen Sie die Schaltfläche „Ausführen“ am Canvas aus. Das Popup-Fenster „Auswahlen“ wird geöffnet.
Wählen Sie das Filter-Symbol neben einer Dimension aus, um eine Inline-Mitgliederauswahl mit einer hierarchischen Liste der autorisierten Mitglieder zu öffnen.
Prüfen Sie ein oder mehrere Elemente pro Dimension und wählen Sie „OK“. Ausgewählte Elemente werden mit einem schreibgeschützten „LM“-Beziehungsindikator angezeigt.
Um Elemente zu entfernen, aktivieren Sie das Kontrollkästchen daneben und wählen Sie das Papierkorbsymbol aus.
Stellen Sie sicher, dass in allen Dimensionen mindestens eine Auswahl getroffen wurde (die Schaltfläche „RUN“ ist deaktiviert, bis alle Dimensionen ausgefüllt sind), und wählen Sie dann „RUN“ aus, um den Vorgang auszuführen.

Die Auswahlen werden während des Ausführens an alle FAContext-konfigurierten Workflow-Knoten übergeben. Bei SQL-Skripten, die Kontextwerte verwenden, wird die Mehrfachauswahl unterstützt. Das System generiert für jede Ausführung Erfassungen im Ereignisprotokoll, und die Kontext-Auswahlen bleiben erhalten, wenn das Popup-Fenster „Ausführen“ erneut geöffnet wird.

Note: Wenn „SQL ausführen“ im Skript-Editor verwendet wird oder die Ausgabe außerhalb eines Laufs angezeigt wird, verwendet das System L2-Header-Kontext-Auswahlen anstelle der Auswahlen aus dem Popup-Fenster „Ausführen“.

v26.02: Ausführen von Workflows aus Aktivitätsaufgaben

Workflows können zu „Berechnung- und Datenfluss“-Aufgaben in Prozessabläufen hinzugefügt werden, wodurch das Ausführen direkt aus Aktivitätsaufgaben heraus möglich ist, ohne auf die gesamte Workflow-Arbeitsfläche zugreifen zu müssen.

Wenn ein Benutzer eine Aufgabe öffnet, die Workflows aus einer Aktivität enthält, wird ein Seitenbereich geöffnet, in dem die aus den Workflow-Knoten abgeleiteten Dimensionen angezeigt werden. Dimensionen, die mit der Aktivität übereinstimmen, werden automatisch mit Kontextwerten gefüllt. Benutzer wählen die Schaltfläche „Berechnen“, um den Workflow von Anfang bis Ende auszuführen, und können die Auswahlen bei Bedarf ändern und den Workflow erneut ausführen.

Jeder Workflow-Eintrag in der Aufgabenkonfiguration enthält ein Kontrollkästchen „Aktiv“ (steuert die Sichtbarkeit in der Aktivität) und ein Kontrollkästchen „Standardformeln ausführen“ (steuert die Reihenfolge der Formelauflösung). Mehrere Workflows werden nacheinander in der Reihenfolge ihrer Darstellung ausgeführt.

Das System erstellt für jeden Durchlauf Ausführungsprotokolle, in denen der Ausführungsstatus, Benutzerdetails, Auswahlen der Dimensionen und der Status der einzelnen Knoten erfasst werden.

v26.05: Ausführen von Workflows mit Knoten zum Hochladen von Dateien

Wenn der Workflow einen oder mehrere Knoten zum Datei hochladen enthält, zeigt der Dialog zum Ausführen neben dem vorhandenen Popup-Fenster „Auswahlen“ einen eigenen Abschnitt „Datei hochladen“ pro Knoten zum Datei hochladen an. Jeder Block zum Hochladen von Dateien enthält eine Schaltfläche „Datei auswählen“, ein Dropdown-Menü „Kodierung“ (Standardwert: UTF-8) und ein Dropdown-Menü „Trennzeichen“ (Standardwert: Komma). Die Schaltfläche „AUSFÜHREN“ bleibt deaktiviert, bis für jeden Knoten zum Hochladen von Dateien eine gültige Datei hochgeladen wurde.

Der Abschnitt „Zuvor hochgeladene Dateien“, der auf den angemeldeten Benutzer beschränkt ist, listet vergangene Laufzeit-Uploads in umgekehrter chronologischer Reihenfolge mit Zeitstempel und Auslösersymbol auf. Nur die Datei, die tatsächlich während des Ausführens verwendet wurde, wird dem Verlauf hinzugefügt – bei der Entwurfsphase konfigurierte Beispieldateien und verworfene Auswahlen werden ausgeschlossen.

Details zur Konfiguration von Knoten vom Typ „Datei hochladen“ finden Sie unter Leseknoten „Datei hochladen“.

Anzeigen der Ausführungsausgabe

So zeigen Sie die Ausführungsausgabe an:

Suchen Sie den Abschnitt „Ausgabe der Ausführung“ am unteren Rand des Canvas.
Klicken Sie auf das Symbol zum Erweitern, um den Abschnitt zu öffnen.
Wechseln Sie zwischen den Registerkarten:
- Registerkarte „Daten“: Zeigen Sie die verarbeiteten Daten an (mit einem Standardwert von 500 Zeilen).
- Registerkarte „Meldungen“: Zeigt Ausführungsprotokolle mit Zeitstempel, Knotenname, Meldungstyp (Info, Warnung, Fehler) und Details an.
v26.10: Die Registerkarte „Meldungen“ zeigt die Meldungen des ausgewählten Knotens an und ist leer, bis Sie den Knoten ausführen oder eine Vorschau anzeigen. Wenn die Vorschau auf der Registerkarte „Daten“ abgeschnitten ist, zeigt die Registerkarte „Meldung“ an, wie viele Zeilen angezeigt werden und wie viele es insgesamt sind, zum Beispiel: 1000 von 100.000 Datensätzen werden angezeigt. Bitte wenden Sie Filter an, um die Ergebnisse einzugrenzen.

Fehlerbehebung

Wenn während des Ausführens des Workflows Fehler auftreten:

Prüfen Sie die Knoten mit Fehlersymbolen am Canvas.
Öffnen Sie den Abschnitt „Ausführungsausgabe“.
Klicken Sie auf die Registerkarte Meldung.
Überprüfen Sie die Fehlerdetails, einschließlich Knotenname, Fehlertyp und Fehlermeldung.
Korrigieren Sie die Konfiguration im betroffenen Knoten.
Klicken Sie auf Veröffentlichen, um die Korrekturen zu speichern.
Klicken Sie erneut auf Ausführen, um die Ausführung zu wiederholen.

v26.10: Jeder Knoten meldet eine Meldung, die den Namen des Fehlers angibt, z. B. eine gelöschte Quelle oder ein gelöschtes Ziel, eine fehlende Eingabe, eine leere Tabelle oder übersprungene Zeilen, weil ein Element nicht vorhanden ist. Die Meldung endet mit dem Knotenamen und dem Vermerk „Erfolgreich“ oder „Fehlgeschlagen“. Nach einem Ausführen listet das Ereignisprotokoll die Meldungen aller Knoten in der Reihenfolge ihrer Ausführung auf. Ein Ausführen über das Canvas und ein Ausführen über eine Aufgabe erzeugen dieselben Meldungen.

v26.10: Knoten nach einer Änderung der Quelle aktualisieren

Wenn sich ein Blatt, eine Transaktionstabelle, eine Remote-Tabelle, eine Dimension oder eine Zuordnungstabelle nach dem Veröffentlichen eines Lese-, Schreib- oder Zuordnungs-Knotens ändert, kennzeichnet der Workflow den Knoten, wenn Sie den Workflow öffnen. Der Knoten wird auf dem Canvas mit einem Ausrufezeichen gekennzeichnet, und in seiner L2-Kopfzeile wird die Meldung Eingabe-Tabelle aktualisiert angezeigt. Die Markierung dient lediglich als Hinweis, und der Knoten behält seine Struktur bei, bis Sie eine Aktualisierung durchführen. Eine Umbenennung führt nicht zur Markierung eines Knotens. Wenn Sie den Workflow ausführen, ohne den Knoten zu aktualisieren, erscheint dieselbe Meldung für den Knoten im Ereignisprotokoll.

So aktualisieren Sie einen markierten Knoten:

Öffnen Sie den Knoten.
Fügen Sie die Komponente der Quelle erneut hinzu.
Überprüfen Sie die Änderungen und wählen Sie anschließend Veröffentlichen aus.

Durch das erneute Hinzufügen der Quelle bleiben die Auswahlen, das Layout, die Filter und die Zuordnungen, die noch gültig sind, erhalten. Elemente, die an der Quelle entfernt wurden, werden aus dem Knoten entfernt, und ein geänderter Datentyp wird angewendet. An der Quelle hinzugefügte Elemente sind verfügbar, aber nicht ausgewählt: Eine neue Kennzahl erscheint in der Metrikauswahl, und eine neue Dimension oder Eigenschaft erscheint im Abschnitt Liste aktualisieren.

Note: Ein Zuordnungsknoten hat keine Quelle, die erneut hinzugefügt werden könnte. Öffnen Sie den betroffenen Schritt, korrigieren Sie die Spalte der Quelle oder des Ziels und veröffentlichen Sie anschließend.

Note: Eine Remote-Tabelle, die in den Typ „Virtual“ geändert wird, kann nicht mehr als Quelle für einen Leseknoten dienen.