Reguläre Ausdrücke, bekannt als Regex, ermöglichen es Ihnen, dynamischen Text zu manipulieren, der in WalkMe-Inhalten angezeigt wird oder Teil automatisierter Prozesse ist. Die Verwendung der Regex-Syntax ist ideal für Situationen, in denen die von Ihnen verwendeten dynamischen Textwerte sowohl die gewünschten Werte als auch andere, nicht relevante Zeichen enthalten.
Wenn dynamischer Text den Vor- und Nachnamen eines Nutzers enthält, verwenden Sie Regex, um nur den Vornamen in einem ShoutOut oder Balloon auszuwählen und anzuzeigen, um es persönlicher zu gestalten (visuelle Anzeige)
Füllen Sie die E-Mail-Adresse Ihrer Nutzer (wenn sie Teil eines größeren Objekts mit zusätzlichen Daten ist) beim Laden der Seite automatisch in ein Textfeld ein (Automatisierung)
Wählen Sie nur einen Teil einer URL aus, wenn Sie dynamischen Text verwenden, um den Nutzer automatisch auf eine andere Seite zu leiten
Example use case
Ein Kunde möchte, dass ein SmartTip angezeigt wird, wenn ein On-Screen-Element, das ein Datum anzeigt, vor oder gleich dem 31. Januar 2019 liegt.
So gehen Sie das Problem an:
Skizzieren Sie mögliche Werte, die Sie abgleichen möchten, und Werte, die Sie nicht abgleichen möchten
Teilen Sie das Problem in mehrere Regelgruppen auf, die in Kombination alle Werte abdecken, die Sie abgleichen möchten
In diesem Beispiel haben wir vier verschiedene Muster, die wir abgleichen möchten:
Any dates during January 2019
Any date between January 1, 2010 and December 31, 2018
Any date between January 1, 2000 and December 31, 2009
Any date between January 1, 0000 and December 31, 1999
Erstellen Sie die Regeln, um jeden der oben genannten Fälle zu behandeln, und testen Sie sie:
^Jan[\s]+[0123]?[\d]+,[\s]+2019$
^[\w]+[\s]+[0123]?[\d]+,[\s]+201[012345678]$
^[\w]+[\s]+[0123]?[\d]+,[\s]+200[0123456789]$
^[\w]+[\s]+[0123]?[\d]+,[\s]+[01][\d]{3}$
Nachdem Sie jede Gruppe getestet haben, kombinieren Sie sie mithilfe der Pipe zu einem String (entfernen Sie überschüssige ^ und $)
Implementieren Sie die oben genannte RegEx in der Anzeigesegmentregel des SmartTips mit:
OSE/jQuery > Text is per Regular Expression > ^Jan[\s]+[0123]?[\d]+,[\s]+2019|[\w]+[\s]+[0123]?[\d]+,[\s]+201[012345678]|[\w]+[\s]+[0123]?[\d]+,[\s]+200[0123456789]|[\w]+[\s]+[0123]?[\d]+,[\s]+[01][\d]{3}$
Ergebnis: SmartTip wird angezeigt, wenn der Textwert des Elements vom 1. Januar 0000 bis zum 31. Jan 2019 reicht
How It Works
Beginnen Sie mit einem öffnenden Regex-Tag, das den regulären Ausdruck selbst enthält, gefolgt von der Anweisung, auf die Sie den regulären Ausdruck anwenden möchten, und schließen Sie mit einem schließenden Regex-Tag ab:
[regex="{the regex itself}"]{text to perform the regex on}[/regex]
Anmerkung
{Text zur Durchführung der Regex} kann eine Mischung aus mehreren dynamischen Textwerten wie Variablen, Cookies, WalkMe Daten und jQuery sowie statischen Werten sein
Der Großteil, wenn nicht alle Textverwendungen in Regex werden dynamisch sein, mit minimaler Verwendung von statischen Textwerten.
Unterstützte Verwendung von Regex bei WalkMe
Bedingungs-Builder-Regeltypen:
Ausgewähltes Element
URL
Benutzerattribute
jQuery
Auf dem Bildschirmelement
Variable (Benutzerdaten)
BBCode für WalkMe-Inhalte:
Visuelle Anzeige
Smart Walk-Thru Schritt
ShoutOut
Anleitung SmartTip
Survey
Automatisierung
Smart Walk-Thru Auto-Schritt (Text einfügen und Listenwert auswählen);
Umleitungsschritt für Smart Walk-Thrus
Regex Structure
Starting and ending demarcators
Außerhalb von Klammern kennzeichnet ^ den Anfang einer Regex und wird zusammen mit $ verwendet, um das Ende der Regex zu kennzeichnen.
Beispiele
In einem Erweiterungspaket: ^https:\/\/ecolab\.my\.salesforce\.com.*|^https:\/\/ecolab.*na.*\.visual\.force\.com.*
Regex im Bedingungs-Builder: Benutzerdaten → Variable → Abteilung → Ist pro regulären Ausdruck → ^sales$
Single character match
Die einfachste Form von Regex führt einen direkten Zeichenabgleich durch.
Beispiele
^walkme$
Wird „walkme„ entsprechen
Lists and ranges
[] kann verwendet werden, um eine Liste von Werten anzugeben, und in Kombination mit – kann es einen Wertebereich festlegen, den ein entsprechendes Zeichen im Ziel-String annehmen kann.
Beispiele
^[dcr][ao][gt]$
Passt zu „Hund„ „Katze„ „Ratte„ „Lappen"
Das erste Zeichen muss d, c oder r sein; das zweite Zeichen muss a oder o sein, und das dritte Zeichen muss g oder t sein
^[a-z][0-9]$
Das erste Zeichen muss a bis z (Kleinbuchstaben) sein und das zweite Zeichen muss 0 bis 9 sein
Repetitions
{3} and {#,#} can be used to avoid having to type the same patterns repeatedly in succession within a regex.
Beispiele
^[a-z]{3}$
Stimmt mit drei Kleinbuchstaben in Folge überein, z. B. „adf„ oder „kzd„.
^[a-z]{1,3}$
Stimmt mit mindestens einem und höchstens drei der vorangehenden Zeichen überein, z. B. „a„ „am„ und „abc„, aber nicht „duct„.
Wildcards
Diese sind nützlich, wenn Text im Ziel-String dynamisch ist oder wenn der Inhalt keine Rolle spielt. . entspricht einem beliebigen einzelnen Zeichen, * entspricht null oder mehr des vorangehenden Musters und + entspricht einem oder mehr des vorangehenden Musters.
Beispiele
^.*$
Entspricht Null oder mehr oder beliebigen Zeichen und ist nützlich, wenn es am Anfang und am Ende einer RegEx eingefügt wird (insbesondere innerhalb von Erweiterungen), da wir nur an passenden Subdomains interessiert sind
^a+b*c+$
Entspricht, da + angibt, dass mindestens eines der vorangehenden Zeichen vorhanden sein muss
Escape character
Der Backslash \ kennzeichnet, dass die folgenden Zeichen eine besondere Bedeutung haben.
Beispiele
\.
Steht für einen Punkt und nicht für einen Platzhalter
\/, \$
Passt zu a / und $
\d und \D
Entspricht einem numerischen und einem nicht numerischen Zeichen
\s und \S
Passt zu einem Leerzeichen\Nicht-Leerzeichen
\w und \W
Passt zu einem alphanumerischen und nicht alphanumerischen Zeichen
Exclusion character
Wenn es innerhalb von [] enthalten ist, kann ^ kennzeichnen, dass das Zeichen im Ziel-String nicht vorhanden sein darf.
Beispiele
^[^abc]$
Passt zu jedem einzelnen Zeichen, das nicht a, b oder c ist
^[^n-p]$
Passt zu jedem einzelnen Zeichen, das nicht n, o oder p ist
^\w[^og]{2}$
Passt zu bee und sea, aber nicht zu log, bog, fog usw.
Negative lookahead
(?!) gibt an, dass der folgende String nicht im Match enthalten sein darf, und ist z. B. nützlich, um zu verhindern, dass eine WalkMe-Erweiterung in das falsche iFrame injiziert.