Kurzübersicht

Bei der Konfiguration einer WalkMe-Erweiterung verwenden Sie Regex, um zu definieren, in welche Domänen WalkMe eingebunden werden soll. Dieser Artikel behandelt allgemeine Regex-Richtlinien und plattformspezifische Beispiele für Salesforce, Workday und SuccessFactors.

Allgemeine Richtlinien

Seien Sie spezifisch, aber flexibel

Regex sollte so spezifisch wie möglich sein und trotzdem auf verschiedenen Seiten funktionieren. Verwenden Sie kundenspezifische Präfixe, um dieses Gleichgewicht zu erreichen.

Verwenden Sie für jede Umgebung ein anderes Regex

Jede Umgebung muss ihr eigenes eindeutiges Regex haben. Verwenden Sie Präfixe, um zwischen Produktion und Sandbox zu unterscheiden.

Regex immer mit .* umschließen

Beginnen und beenden Sie jede Regex-Zeichenfolge mit .*

Ersetzen Sie Zahlen durch .*

Anstatt bestimmte Ziffern zu verwenden, verwenden Sie stattdessen .*.

Maskieren Sie Punkte mit \

Setzen Sie immer ein \ vor jeden Punkt.

Maskieren Sie Bindestriche nicht

Verwenden Sie (erste|zweite) für mehrere Präfixe

Um eine URL mit zwei oder mehr verschiedenen Präfixen einzubeziehen, verwenden Sie (erste|zweite|dritte), wo die Präfixe vorkommen.

Verwenden Sie Negative Lookahead, um Wörter auszuschließen

Um ein bestimmtes Wort von einer Übereinstimmung auszuschließen, verwenden Sie (?!word).

Kombinieren Sie mehrere Regex mit |

Um mehr als eine Regex in ein Paket aufzunehmen, trennen Sie jede Regex mit | und ohne Leerzeichen.

Bei Regex müssen Sie auf Klein- und Großschreibung achten.

Passen Sie immer genau die Groß- und Kleinschreibung der URL in Ihrem Regex an.

Stricter Domain Regex

In einigen Fällen müssen Sie die Injektion möglicherweise auf einen bestimmten iFrame beschränken und gleichzeitig verhindern, dass WalkMe in anderen iFrames geladen wird, die auf dieselbe Domäne verweisen.

^https?://[^/]*(visual\.force)\.com

App-spezifische Regex

Salesforce

Salesforce-Erweiterungen erfordern aufgrund der Varianz zwischen den Seiten und des Vorhandenseins von Analytik-iFrames besondere Sorgfalt.

Beim Erstellen der Erweiterung:

• Verwenden Sie ein negatives Lookahead, um Session-Server und andere unnötige Einfügungen zu vermeiden: (?!/(login/sessionserver|s\.gif)
• Verwenden Sie die "Oder"-Logik innerhalb eines Pakets, anstatt zwei separate Erweiterungen zu erstellen.
• Das Server-Präfix ("na", "ap", "eu", "cs") bleibt im Allgemeinen gleich – bleiben Sie bei der URL, die Sie haben.

Testumgebungen

Salesforce Classic:

.*customername.*\.cs.*\.my\.salesforce\.com.*|.*cs.*\.salesforce\.com/(?!console).*|.*cs.*\.visual\.force\.com.*

Salesforce Lightning:

.*cs.*\.lightning\.force\.com.*

Salesforce Console

.*cs.*\.salesforce\.com/console.*

Produktionsumgebungen

Salesforce Classic:

.*customername.my.salesforce.com.*|.*na.*.salesforce.com/(?!console).*|.*na.*.visual.force.com.*

Salesforce Lightning:

.*na.*.lightning.force.com.*

Salesforce Console

.*na.*\.salesforce\.com/console.*

Workday®

Test: .*impl\.workday\.com/customername.*

Produktion: .*myworkday\.com/customername.*

SuccessFactors

Test: .*hcm.*preview\.sapsf\.com.*

Produktion: .*performancemanager.*\.successfactors\.com.*

Unterscheiden zwischen ähnlichen URLs

Bei der Konfiguration von Erweiterungen für Plattformen mit ähnlichen URLs – z. B. Standard-Salesforce und Salesforce Service Cloud – verwenden Sie Regex, um zwischen ihnen zu unterscheiden.

Normale SFDC-URL: https://cs2.salesforce.com/home/home.jsp?tsid=02u0000000000hV

Service-Cloud-URL: https://cs2.salesforce.com/console?tsid=02u50000000e56v

Der Unterschied besteht darin, dass das Wort "console" nach salesforce.com erscheint. Nutzen Sie dies zu Ihrem Vorteil:

Service Cloud Regex:

.*cs2.salesforce.com/console.*

Verwenden Sie für SFDC einen negativen Lookahead, um jede URL auszuschließen, bei der "console" auf salesforce.com folgt:

SFDC regex:

.*cs2.salesforce.com/(?!console).*

Dies entspricht https://cs2.salesforce.com/home/home.jsp, aber nicht https://cs2.salesforce.com/console.