v26.04: Arbeiten mit Parametern

Workflows unterstützen globale Parameter, mit denen Benutzer wiederverwendbare Werte auf Workflow-Ebene definieren können. Parameter werden zur Laufzeit aufgelöst und an alle referenzierenden Knoten innerhalb eines Workflows weitergegeben.

Im Bereich Globale Parameter sind zwei Arten von Parametern verfügbar:

• Automatisierte Parameter - Systemdefinierte Parameter, die zur Laufzeit ohne Benutzereingabe automatisch aufgelöst werden:

  • Zeit

  • Konto

  • Datum der Ausführung

  • Durchführungszeitraum

  • Ausführungsbenutzer

• Benutzerparameter - Benutzerdefinierte Parameter, die vom Benutzer erstellt wurden. Jeder Benutzerparameter umfasst:

  • {{name}} Kennung des Parameters

  • Typ Datentyp (Text, usw.)

  • Quelle Wertquelle (Konstante, etc.)

  • Wert: Der Parameterwert

Parameter konfigurieren

Um Parameter zu konfigurieren:

1. Öffnen Sie den Workflow-Designer und wählen Sie einen Workflow aus.

2. Wählen Sie in der Symbolleiste der Kopfzeile L2 die Option Params.

3. Auf der rechten Seite öffnet sich der Bereich Globale Parameter mit den Abschnitten Automatisierte Parameter und Benutzerparameter.

4. Um einen Benutzerparameter hinzuzufügen, geben Sie den Parameternamen in das Feld Neuer Parametername unter Benutzerparameter ein.

5. Wählen Sie die Schaltfläche +, um den Parameter hinzuzufügen.

6. Konfigurieren Sie die Eigenschaften der Parameter: Name, Typ, Quelle und Wert.

7. Wählen Sie Veröffentlichen, um den Workflow mit den neuen Parametern zu speichern.

Parameter in Knoten verwenden

Parameter können in Knotenkonfigurationen mit der Syntax ${parameter_name} referenziert werden. Wenn ein Workflow ausgeführt wird, löst das System alle Parameterreferenzen auf, bevor die Verarbeitung beginnt.

Die Parameterunterstützung erstreckt sich auf die folgenden Knotentypen:

Parameter in SQL-Skriptknoten

Im Modus Erweiterte Ansicht wird unter dem Feld Abfrage ein Abschnitt Verfügbare Parameter angezeigt. Benutzer können Parameter-Tags (wie Zeit, Konto, Ausführungsdatum) auswählen, um sie in die SQL-Abfrage einzufügen. Das System löst die Parameterwerte auf, bevor es das SQL-Skript ausführt. Parameter können in Knotenkonfigurationen mit der Syntax ${parameter_name} referenziert werden.

Parameter in entfernten Tabellen-Leseknoten

Benutzer können Workflow-Parameter in Konfigurationen zum Lesen von Remote-Tabellen aufnehmen, um den Datenabruf aus externen Quellen dynamisch zu filtern oder zu parametrisieren.

v26.10: Parameter in Knoten für Blätter und Transaktionstabellen

In Knoten vom Typ „Tabelle lesen“ und „Transaktionstabelle lesen“ sowie im Abschnitt Überschreiben basierend auf der Knoten „Blatt schreiben“ und „Transaktionstabelle schreiben“ verfügt der Element-Selektor einer globalen Dimension über eine ein- und ausklappbare Gruppe Parameter oberhalb der Elementliste. Die Gruppe listet alle Workflow-Parameter auf, wobei benutzerdefinierte Parameter an erster Stelle und automatisierte Parameter an letzter Stelle stehen. Wählen Sie Parameter, Elemente oder beides für dieselbe Dimension aus.

Bei einer lokalen Dimension in einem Knoten „Transaktionstabelle lesen“ oder im Abschnitt Überschreiben basierend auf eines Knotens „Transaktionstabelle schreiben“ öffnet das Filtersymbol nur eine Liste mit Parametern. Eine Dimension mit markierten Parametern zeigt einen Pfeil an, über den diese aufgelistet werden, und Sie können einen Parameter aus dieser Liste entfernen.

Zur Laufzeit besteht die Auswahl für eine Dimension aus ihren festen Elementen sowie den Elementen, auf die sich die einzelnen markierten Parameter auflösen, ohne Duplikate. Ein „Write“-Knoten löscht vor dem Schreiben nur die Zeilen innerhalb des resultierenden Überschreibungsbereichs.

Hinweis: Parameter-Auswahlen werden zur Laufzeit erst wirksam, nachdem Sie den Workflow veröffentlicht haben. Ein Parameterwert, der kein Element der Dimension ist, fügt der Auswahl nichts hinzu und verursacht keinen Fehler.

Hinweis: Ein „Read“-Knoten, der für das Markieren keine Zeilen zurückgibt, wird dennoch erfolgreich ausgeführt, und der Workflow wird mit einem leeren Datensatz fortgesetzt. Wenn der Überschreibungsbereich eines Schreibknotens mit keiner Zeile im Ziel übereinstimmt, schlägt der Knoten fehl und gibt die Meldung Überschreiben fehlgeschlagen. Es werden 0 Datensätze zurückgegeben., der Schreibvorgang wird abgebrochen und der Workflow wird beendet.

v26.10: Parameter in Stammdaten-Leseknoten

In einem Knoten „Stammdaten lesen“ verfügt jede Eigenschaft, die nicht lokalisiert ist, über ein Filtersymbol links neben dem Kebab-Menü. Das Symbol öffnet eine Liste mit Workflow-Parametern. Wählen Sie einen oder mehrere Parameter aus, um nur die Zeilen zurückzugeben, deren Wert mit den Elementen übereinstimmt, auf die die Parameter aufgelöst werden. Wenn kein Parameter markiert ist, gibt die Eigenschaft alle Werte zurück. Eine Eigenschaft mit markierten Parametern zeigt einen Pfeil an, über den diese aufgelistet werden. Lokalisierte Eigenschaften verfügen nicht über ein Filtersymbol.

Wenn ein Parameter auf mehrere Elemente aufgelöst wird, gelten alle diese Elemente. Wenn Sie mehr als einen Parameter für eine Eigenschaft markieren, werden die aufgelösten Werte ohne Duplikate kombiniert.

Hinweis: Parameter-Auswahlen werden zur Laufzeit erst wirksam, nachdem Sie den Workflow veröffentlicht haben.