Der Ausdruckseditor dient dem Zweck, die Eingabe von komplexen Ausdrücken im Workflow-Designer zu vereinfachen. Durch einen Klick auf die Schaltfläche können Sie den Ausdruckseditor in jedem Ausdrucksfeld aufrufen. Wichtig sind außerdem die System-Argumente - mit ihnen können Sie z.B. feststellen, wer den Worklfow gestartet hat.

Ausdruckseditor im WMS Workflow Designer

Inhalt

1 Texteditor
- 1.1 Pfad
- 1.2 SQL
2 Variable erstellen WMS 1.1.4
3 Verfügbare Daten und Funktionen
- 3.1 Daten/Funktionen
  - 3.1.1 Variablen und Argumente
  - 3.1.2 Eigenschaften einer Aktivität
  - 3.1.3 System-Argumente
- 3.2 Funktionen
- 3.3 Operatoren

Hilfe zu VB-Ausdrücken:

Texteditor

Das Eingabefeld akzeptiert nur gültige VisualBasic-Ausdrücke des angeforderten Datentyps. Der Datentyp wird Ihnen über dem Eingabefeld angezeigt. Sie haben die Möglichkeit selbst einen Ausdruck einzugeben oder über die darunterliegende Baum-Übersicht einen Ausdruck (z.B. eine Variable oder eine Methode) mit einem Doppelklick einzufügen.

Mit "Strg" + "Leertaste" erhalten Sie eine Liste aller verfügbaren Variablen und Argumente (siehe unten). Die Variablen mit passendem Typ werden Ihnen dabei oben angezeigt und hervorgehoben.

Pfad

Über die Schaltfläche am rechten Rand des Textfeldes öffnet sich ein Dialog zur Auswahl von Verzeichnissen. Beachten Sie, dass Sie hier nur Verzeichnisse auswählen können, die in der System Administration für Ihren Mandanten freigegeben sind.

Beim Bestätigen des Dialogs wird der Pfad des ausgewählten Verzeichnisses automatisch in das Textfeld übernommen.

SQL

Über die Schaltfläche am rechten Rand des Textfelds öffnet sich ein Dialog zur Eingabe eines SQL-Ausdrucks. Unterstützend zeigt der Texteditor Schlüsselwörter von SQL Fett in blau an.

Bei Bestätigen des Dialogs wird der Ausdruck als String in das Textfeld übernommen.

Variable erstellen WMS 1.1.4

Über die Schaltfläche “Variable erstellen” können Sie eine passende Variable für den aktuellen Ausdruck erstellen.

Geben Sie dazu einen passenden Namen ein und wählen Sie ggf einen anderen Bereich (Aktivität, in der die Variable angelegt werden kann). Der Typ wird automatisch auf den erforderlichen Typ des Ausdrucks gesetzt.

Beachten Sie, dass der Name eindeutig sein muss und keine Sonderzeichen enhalten darf. (-> Namensgebung von Variablen).

Zuordnungsvariablen können hier (z.B. für eine SMTP-Einstellung ) nicht angelegt werden. Wechseln Sie dazu in das Zuordnungenfenster.

Ist eine Variable vom Typ ICollection gefordert (z.B. bei "Add range to collection"), dann wird immer eine Variable vom Typ “List” angelegt und initialisiert (z.B. mit “New List (Of Guid)”).

Verfügbare Daten und Funktionen

Daten/Funktionen

In diesem Tab werden Ihnen alle Variablen und Argumente angezeigt, die in der ausgewählten Aktivität zur Verfügung stehen. Auf der rechten Seite können Sie den Datentyp der Variable einsehen sowie eine Beschreibung des Datentyps.

Durch einen Doppelklick auf den Variablennamen wird dieser in das Textfeld übernommen. Möchten Sie eine Eigenschaft des Variablen-Objekts einfügen, setzt der Ausdruckseditor mit einem Doppelklick den Ausdruck zusammen.

Variablen und Argumente

Hier finden Sie alle Variablen und Argumente der Workflow-Definition, die in dem aktuellen Bereich verwendet werden können. Dazu zählen sowohl selbst, als auch durch die Zuordnungen angelegte Variablen.

Eigenschaften einer Aktivität

Mit Eigenschaften einer Aktivität sind alle "internen" Variablen gemeint, die eine Aktivität zur Verfügung stellt. Dazu z.B. das item in der ForEach-Aktivität.

System-Argumente

Unter System-Argumente finden Sie Daten, die das WMS jedem Workflow zur Verfügung stellt, um Informationen aus der Workflow-Laufzeit zu beziehen. Folgende System-Argumente stehen Ihnen zur Verfügung:

SYS_StartedById	Id des Benutzers, der die Workflow-Instanz gestartet hat. Die Guid ist leer, wenn der Workflow durch einen Ausführungsplan gestartet wurde.
SYS_StartedWorkflowDefName	Name der Workflow-Definition, die ein Benutzer bzw. ein Ausführungsplan gestartet hat.
SYS_WorkflowDefName	Name der aktuellen Workflow-Definition.

Sobald Sie eine Systemargument im Ausdruckseditor verwenden (z.B. durch Doppelklick einfügen) wird in der Workflow-Definition ein neues Argument mit diesem Namen eingefügt.

Wichtig: Greifen Sie auf diese Argumente nur lesend zu. Ändern Sie weder ihren Namen, den Datentyp oder Wert, um sie verwenden zu können.

Weitere Details zu VB-Ausdrücken:

Funktionen

In diesem Tab werden Ihnen einige verfügbare Methoden angezeigt, die Sie im Ausdruckseditor verwenden können. Auf der rechten Seite finden sie Informationen zu Rückgabewerten und Parameter der Methode sowie eine Beschreibung, wofür die Methode gedacht ist.

Durch einen Doppelklick auf eine Methode wird diese in das Textfeld übernommen. Geben sie gegebenenfalls Parameter für die Methode ein.

String.IsNullOrEmpty	Prüft ob ein String einen Wert enthält, also nicht “nothing” und nicht ““ ist.
Environment.NewLine	Fügt einen Zeilenumbruch ein.
Path.Combine	Verknüpft angegeben Ordner und Dateinamen mit “/” zu einem Pfad.
WmsHelper.HtmlToText	Extrahiert aus einem HTML-Text den lesbaren Text zum Anzeigen.

Operatoren

In diesem Tab werden Ihnen die verfügbaren Operatoren angezeigt. Auf der rechten Seite finden Sie eine genauere Beschreibung des Operators.

Durch einen Doppelklick wird der Operator in das Textfeld übernommen.