- pdf
Fields & Variables
- pdf
Da die Navigationsbereiche Fields und Variables inhaltlich miteinander verwandte Elemente enthalten, findest Du hier Informationen und Beispiele zu beiden Bereichen.
Fields
Dieser Abschnitt enthält Frage- und Antwortfelder sowie Operatoren, mit denen Du den Wert eines bestimmten Feldes (z.B. eines Produkts) abrufst oder änderst.
Select a question: Element, um eine bestimmte Frage des Fragebogens abzurufen.
Select an answer: Element, um eine bestimmte Antwort des Fragebogens abzurufen.
get-of: Ermöglicht den Bezug zu bestimmten Objekten oder Eigenschaften (Attributen) von Objekten.
Set-of-to: Ermöglicht es, die Eigenschaft von Objekten auf einen bestimmten Wert zu setzen.
Variables
Variablen werden verwendet, um einen Wert zu speichern, welcher sich ändern kann (d.h. variabel ist).
get: Ausdruck, mit welchem auf den Wert einer Variable zugegriffen wird.
set-to: Ausdruck, mit welchem der Wert einer Variablen beeinflusst oder eine neue Variable generiert wird.
⚠️ Hinweis zur Konfiguration der folgenden Beispiele
Die folgenden Beispiele zeigen exemplarische Regeln. Um das Ergebnis einer Regel (d.h. den Inhalt eines angelegten Feldes) auf der Ergebnisseite auszuspielen, muss das Feld immer zusätzlich über den Workbench-Navigationspunkt Result Page konfiguriert werden. Zur Wahrung der Übersichtlichkeit zeigen wir diesen Schritt in den Beispielen nicht. Beachte dazu den verwandten Artikel.
Beispiel 1: Variablenwerte erstellen / verändern
In diesem Beispiel wird der Wert der Variablen product_count auf den Wert 5 gesetzt (siehe Zahlenfeld "1" aus dem Navigationspunkt Math). Die Variable kann in diesem Beispiel ein Attribut aus den Produktdaten sein.
Wenn die Variable product_count noch nicht existiert (d.h. kein Bestandteil der Produktdaten ist), wird diese bei Verwendung des Elements automatisch erstellt. Den Namen der Variable kannst Du frei wählen. Vermeide bei der Benennung Leerzeichen.
Beispiel 2: Auf Variablenwerte zugreifen
In diesem Beispiel wird der Wert der benutzerdefinierten Variablen product_count abgefragt. Gemäß dem Beispiel 1 wäre das Ergebnis der Abfrage in diesem Fall 5.
Beispiel 3: Produktattribute erstellen / verändern
Im folgenden Beispiel betrachten wir die Erstellung des Attributs Anzahl.
Regel: Alle Produkte aus der Liste der Produktdaten werden in einer Schleife geprüft. Dabei wird das benutzerdefinierte Attribut Anzahl erstellt und für alle auf der Ergebnisseite empfohlenen Produkte auf den Zahlenwert 1 gesetzt.
for each: Loop-Operator, mit dem alle Elemente einer Gruppe in einer Schleife durchlaufen und geprüft werden.
product: Benutzerdefinierter Name. Wichtig ist, dass sowohl in for-each, als auch im Element set-of-to derselbe Name für eine bestimmte Variable verwendet wird (hier im Beispiel: product).
get-products: Die Plattform greift mit diesem Element auf die Liste der Produktempfehlungen zu.
set-Anzahl-of-product-to: Befehl, mit welchem dem benutzerdefinierten Feld Anzahl ein bestimmter Wert zugeordnet wird.
"1": Zahlenfeld mit dem fixen Wert 1. Der Wert kann durch Bearbeiten des Feldes angepasst werden.
Öffne den Navigationspunkt Loop und ziehe das Element for-each-item in den Workspace.
Klicke in das Feld item und tippe product ein.
Wechsle in den Navigationspunkt Variables und ziehe das Element get neben for-each-product. Tippe in das leere Feld products ein (damit die Schleife alle Produkte durchläuft).
Wechsle in den Navigationspunkt Fields und ziehe das Element set-of-to neben das Element do.
Tippe in das erste leere Feld den Namen des Attributs ein, welches Du erstellen möchtest (Beispiel: Anzahl).
Tippe in das zweite leere Feld denselben Ausdruck ein wie im Element for-each (Beispiel: product).
Wechsle in den Navigationspunkt Math und ziehe das Element "1" neben set-Anzahl-of-product-to.
Beispiel 4: Produktattributen einen berechneten Wert zuordnen
Im folgenden Beispiel stellen wir uns vor, dass beim Kauf von mehr als 5 Pinseln ein Pinsel gratis ist. Bei der Eingabe von 6 Pinseln werden auf der Ergebnisseite also 7 Pinsel angezeigt.
Regel:
Alle Produkte aus der Liste der Produktdaten werden in einer Schleife geprüft.
WENN die Anzahl der benötigten Pinsel größer als 5 ist, DANN wird das Attribut Anzahl mit dem Wert aus der Berechnung [Anzahl der Pinsel] + 1 befüllt.
Konfiguration als Video:
Beispiel 5: Produkte mit spezifischem Attribut aus der Empfehlung löschen
Im folgenden Beispiel wollen wir erreichen, dass alle Produkte aus der Empfehlung entfernt werden, die im Attribut Farbe den Wert weiß enthalten. Das Attribut Farbe ist dabei Bestandteil der importierten Produktdaten.
Regel:
Alle Produkte aus der Liste der Produktdaten werden in einer Schleife geprüft.
WENN das Produktattribut Farbe den Wert weiß enthält ("contains"), DANN werden alle Produkte aus der Empfehlung entfernt, die ebendiesen Wert enthalten (anders ausgedrückt: Auf der Ergebnisseite erscheint keine Empfehlung mehr für weiße Farbe).
Öffne den Navigationspunkt Loop und ziehe das Element for-each-item in den Workspace.
Klicke in das Feld item und tippe product ein.
Wechsle in den Navigationspunkt Variables und ziehe das Element get neben for-each-product. Tippe in das leere Feld products ein (damit die Schleife alle Produkte durchläuft).
Wechsle in den Navigationspunkt Logic und ziehe das Element do-if neben das Element do.
Ziehe das Element contains neben das Element if.
Wechsle in den Navigationspunkt Fields und ziehe das Element get-of neben das Element contains. Hinterlege im freien Feld den Namen des Attributs, welches die Plattform nach dem Wert durchsuchen soll (Beispiel: Farbe).
Wechsle in den Navigationspunkt Variables und ziehe das Element get neben das Element get-of. Hinterlege im freien Feld denselben Wert wie im Loop Element (Beispiel: product).
Wechsle in den Navigationspunkt Text und ziehe das Element My text unterhalb des Elements get-Farbe-of-get product. Tippe den gesuchten Wert ein (Beispiel: weiß).
Wechsle in den Navigationspunkt Post Processor und ziehe das Element remove-recommendation neben das Element do.
Kopiere mit Rechtsklick das Element get-products aus der ersten Zeile und füge es neben remove-recommendation ein.