Ausdrücke schreiben
Sie können Ausdrücke schreiben, um Werte anzugeben, die unabhängig von Werten sind oder von Werten abgeleitet werden, die in Schritten erfasst oder in Sitzungsvariablen gespeichert werden. Sie können einen Ausdruck verwenden, um eine Schrittbedingung oder den Wert einer Sitzungsvariablen zu definieren.
Verwenden eines Ausdrucks in einer Schrittbedingung
Sie können einen Ausdruck in einer Schrittbedingung verwenden, wenn Sie einen Schritt auf der Basis von Informationen, die Sie während der Konversation zusammengestellt haben, auf das Ergebnis einer Berechnung festlegen möchten.
Angenommen, ein Kunde hat 200 $ auf einem Sparkonto und möchte 150 $ davon auf ein neues Girokonto überweisen. Die Überweisungsgebühr beträgt 3 $ und die Bank erhebt eine Gebühr, wenn das Guthaben auf einem Sparkonto kleiner als 50 $ ist. Sie können einen Schritt mit einer Schrittbedingung erstellen, die nach dieser Situation sucht. Die Schrittbedingung würde einen Ausdruck wie den folgenden verwenden:
${savings} - (${Step_232} + ${transfer_fee}) < 50
Dabei gilt:
${savings}gibt eine Sitzungsvariable an, in der der Gesamtbetrag für das Sparkonto des Kunden gespeichert ist.${Step_232}gibt an, in welchem Schritt angefragt wird, welchen Betrag der Kunde überweisen möchte.${transfer_fee}gibt eine Sitzungsvariable an, in der die Überweisungsgebühr angegeben wird.
Wenn die Schrittbedingung erfüllt ist, warnt der Schritt den Benutzer, dass durch die angeforderte Überweisung das Guthaben des Sparkontos unter die Mindesteinlage von $ 50 fällt und demnach eine Gebühr berechnet werden würde. Daher ist zum Fortfahren eine Bestätigung erforderlich.
Gehen Sie wie folgt vor, um einen Ausdruck in einer Schrittbedingung zu verwenden:
-
Klicken Sie in dem betreffenden Schritt auf Bedingung hinzufügen.
Eine Bedingung mit der wahrscheinlichsten Option wird automatisch generiert (dabei handelt es sich in der Regel um die im vorherigen Schritt festgelegten Variablen).
-
Klicken Sie auf das erste Segment der generierten Bedingung, blättern Sie abwärts und klicken Sie auf Ausdruck.
-
Optional: Klicken Sie auf das Symbol
Erweitern, um das Fenster des Ausdruckseditors zu öffnen. (Sie können den Ausdruck auch direkt
in das Feld eingeben, ohne das Fenster zu öffnen, aber der Editor erleichtert die Bearbeitung eines längeren oder komplexeren Ausdrucks.) -
Geben Sie den Ausdruck ein, den Sie verwenden möchten.
Verwenden eines Ausdrucks zum Zuweisen eines Werts zu einer Sitzungsvariablen
Sie können einen Ausdruck verwenden, wenn Sie einer Sitzungsvariablen einen Wert zuordnen, wenn der Wert der Variablen auf der Basis anderer Variablen berechnet werden soll.
Beispiel: Angenommen, Sie wollen Ihrem Kunden die Gesamtkosten eines Einkaufs mitteilen, einschließlich 6% Umsatzsteuer und einer unstrukturierten Bearbeitungsgebühr von3.00 €. Um die Gesamtkosten zu berechnen, können Sie eine Sitzungsvariable erstellen und den Wert mithilfe eines Ausdrucks zuordnen:
(${price} * 1.06) + 3
Anschließend können Sie im Feld Assistent sagt auf diese Variable verweisen.
Gehen Sie wie folgt vor, um einen Ausdruck beim Zuweisen eines Werts zu einer Sitzungsvariablen zu verwenden:
-
Klicken Sie in einem Schritt auf Variablenwerte festlegen.
-
Klicken Sie auf Neuen Wert festlegen.
-
Wählen Sie in der Dropdown-Liste die Sitzungsvariable aus, in der Sie den Wert speichern wollen.
-
Wählen Sie nach bis Ausdruck aus.
-
Geben Sie den Ausdruck ein, den Sie verwenden möchten.
-
Wenn Sie den Ausdruckseditor verwenden, klicken Sie auf Anwenden, um Ihre Änderungen zu speichern und das Editorfenster zu schließen.
Sie können einen Ausdruck auch verwenden, um einer Sitzungsvariablen einen Anfangswert zuzuweisen. Rufen Sie im Fenster Sitzungsvariable das Feld Anfangswert auf und klicken auf Ausdruck verwenden.
Sie können einen Ausdruck auch direkt schreiben, ohne zuerst eine Variable auswählen zu müssen:
-
Klicken Sie in einem Schritt auf Variablenwerte festlegen.
-
Klicken Sie auf Neuen Wert festlegen.
-
Wählen Sie in der Dropdown-Liste Ausdruck aus.
-
Geben Sie den Ausdruck ein, den Sie verwenden möchten.
-
Wenn Sie den Ausdruckseditor verwenden, klicken Sie auf Anwenden, um Ihre Änderungen zu speichern und das Editorfenster zu schließen.
Ausdruckssyntax
Derwatsonx Assistant Ausdruckssprache basiert auf der Spring Expression Language (SpEL ), allerdings mit einigen wichtigen Unterschieden in der Syntax. Detaillierte Hintergrundinformationen zuSpEL, sehen Spring Expression Language(SpEL).
Variablen
Um auf eine Variable in einem Ausdruck zu verweisen, geben Sie ein Dollarzeichen ($) ein und wählen Sie dann eine Variable aus der Liste aus. Die Referenz wird in der richtigen Notation in Ihren Ausdruck eingefügt, wobei die Variable
mit ihrer Variablen-ID und nicht mit ihrem Anzeigenamen (z. B. ${step_773} oder ${customer_id}) referenziert wird. Bearbeiten Sie diese Referenz nur, wenn Sie auf eine andere Variable verweisen möchten und Sie sich
über ihre Variablen-ID sicher sind.
Um die benutzerdefinierten Aktions- oder Sitzungsvariablen in einer benutzerdefinierten Clientanwendung zu referenzieren, verwenden Sie das reservierte Schlüsselwortpräfix user_defined_. Verwenden Sie beispielsweise ${user_defined_my_context_var} um den Wert zu erhalten von my_context_var von Ihrem Kunden festgelegt. Weitere Informationen zum benutzerdefinierten Client finden Sie unter benutzerdefinierter Client.
Standardrechenoperationen
Für numerische Werte können Sie Ausdrücke verwenden, um mathematische Berechnungen durchzuführen. Für Basisarithmetik können Sie Standardoperatoren (+, -, *, /) verwenden.
Sie können Methoden auch verwenden, um zusätzliche mathematische Operationen durchzuführen. Weitere Informationen finden Sie unter Methoden der Ausdruckssprache für Aktionen.
Arrays
Um einen Arraywert zu definieren, geben Sie den Wert in eckigen Klammern ein, wobei die Elemente durch Kommas getrennt werden (z. B. [ "one", "two", "three" ]).
Um auf ein Element in einem Array zu verweisen, verwenden Sie die Klammernotation und geben Sie den Index mit der Basis null des Elements im Array an. Beispiel: ${Items}[0] stellt das erste Element im Array dar Items.
Sie können auch die Array-Methode get() verwenden, um ein Element aus einem Array abzurufen. Weitere Informationen finden Sie unter Methoden der Ausdruckssprache für Aktionen.
JSON-Objekte
Verwenden Sie die JSON-Notation, um zusammengesetzte Objekte in Ausdrücken zu definieren. Der folgende Ausdruck weist beispielsweise ein komplexes JSON-Objekt als Wert für eine Variable zu:
{
"name": {
"firstname": "John",
"lastname": "Doe"
},
"age": 36
}
Sie können Variablen und Standardmathematik in JSON verwenden, um dynamische Objekte zu erstellen, die zur Laufzeit berechnet werden. Der folgende Ausdruck definiert beispielsweise ein JSON-Objekt, das auf Variablen verweist und einen Durchschnittswert berechnet:
{
"temp_1": ${temp_1},
"temp_2": ${temp_2},
"avg_temp": (${temp_1} + ${temp_2}) / 2
}
Um auf ein untergeordnetes Objekt zu verweisen, das in einem JSON-Wert enthalten ist, verwenden Sie die Punktschreibweise, um den Pfad zum Objekt auszudrücken (z. B. ${customer}.name.lastname).
Wenn Sie auf ein untergeordnetes Element eines Objekts verweisen müssen, das möglicherweise definiert ist, verwenden Sie den sicheren Navigationsoperator (?). Der Ausdruck ${customer}.name?.lastname ergibt beispielsweise
null, wenn customer.name den Wert null hat. (Ohne den sicheren Navigationsoperator würde ein Fehler auftreten.)
Methoden
Verwenden Sie Methoden der Ausdruckssprache zum Bearbeiten von Werten (z. B. Formatieren einer Zeichenfolge oder Anhängen eines Elements an ein Array). Weitere Informationen zu den unterstützten Methoden für jeden Datentyp finden Sie unter Ausdruckssprachmethoden für Aktionen.