So verwenden Sie Regex, um die Domäne(n) zu definieren, die WalkMe injizieren

Last Updated Mai 28, 2024

Download as PDF

Allgemeine Richtlinien

Regex sollte so konkret wie möglich sein, aber auch allgemein genug, dass es auf verschiedenen Seiten funktioniert. Um dieses Gleichgewicht zu erreichen, verwenden Sie kundenspezifische Präfixe.

• Beispiel:
  • URL: walkme.my.salesforce.com
  • Regex: .*walkme.my.salesforce.com.* anstelle von .*salesforce.com.*

Regex MUSS für jede Umgebung unterschiedlich sein. Hier sind auch Präfixe praktisch.

• Beispiel:
  • Produktions-URL: na3.salesforce.com
  • Sandbox-URL:  cs23.salesforce.com
  • Produktions-Regex: .*na.*.salesforce.com.*
  • Sandbox Regex: .*cs.*.salesforce.com.*

Beginnen und beenden Sie jede Zeichenfolge von Regex mit .*

• Beispiel: .*salesforce.com.*

Anstatt von Ziffern verwenden Sie .*. Ersetzen Sie alle Zahlen in einer URL durch .*

• Beispiel:
  • URL: cs23.salesforce.com
  • Regex: .*cs.*.salesforce.com.*

Sicherstellen, dass vor jedem Punkt ein \ gesetzt wird.

• Beispiel: .*salesforce \. com.*

Bindestriche müssen nicht entfernt werden.

• Beispiel:
  • Verwenden Sie nicht: .*panasonic\-\-full\.salesforce\.com.*
  • Verwenden Sie:  .*panasonic--full\.salesforce\.com.*)

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

• Beispiel:
  • URLs: walkme.salesforce.com  und  sandbox.salesforce.com
  • Regex: .*(walkme|sandbox).salesforce.com.*)

Zum Ausschluss eines Wortes durch eine Regex siehe das folgende Beispiel, bei dem eine Erweiterung mit einem Editorkonto auf Salesforce Classic und einem auf Salesforce Console erstellt werden soll.

• Beispiel:
  • Salesforce klassisch regex:.* cs.*.salesforce.com(?!console).*
    • Hinweis: Dies (?!console) schließt das Wort Konsole in Regex aus.
  • Salesforce-Konsole regex:.* cs.*.salesforce.com/console.*

Wenn Sie mehr als eine Regex in ein Paket aufnehmen möchten, setzen Sie ein | zwischen jede Regex ohne Abstand

• Beispiel: .*cs.*.salesforce.com.*|.*cs.*.visual.force.com.*

Beachten Sie, dass niemals zwei aufeinanderfolgende || in einem Paket stehen dürfen, da dies zu einer Allow-Liste und einer Anpassung an alle URLs führt und auf bestimmten Websites Fehler verursacht.

Bei Regex müssen Sie auf Klein- und Großschreibung achten. Stellen Sie sicher, dass die URL innerhalb von Regex der Klein- bzw. Großschreibung entspricht.

Stricter Domain Regex

Es kann ein Szenario geben, in dem Sie das Regex „festziehen“ müssen, um einen bestimmten Rahmen auszuschließen. Beispielsweise möchten Sie WalkMe in einem bestimmten iFrame injizieren, aber die Domain dieses iFrames ist in vielen anderen iFrames als Referenz enthalten.

Beispiel einer iFrame-Domain für WalkMe: https://visual.force.com/1000

• https://visual.force.com/1000

Beispiel für eine iFrame-Domäne, die wir daran hindern wollen, WalkMe einzubinden

• salesforce.com/referrer?=https://visual.force.com/1000

Um die Regex anzugeben, die am Anfang der URL stehen muss, verwenden wir

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

Mit dieser Regex wird WalkMe nur dann in die Domain https://visual.force.com iFrame eingebunden, wenn es sich um den ersten Teil der URL handelt.

Plattformspezifische Regex-Tipps

Es gibt eine Reihe von Erweiterungen, die wir häufig konfigurieren sollen, die aber schon Standard sind.

Salesforce

Es ist äußerst wichtig, Salesforce-Erweiterungen sorgfältig zu erstellen und sie in einer Reihe von Testszenarien zu testen, da die Plattform seitenübergreifend variiert und viele analytische iFrames vorhanden sind, die 0px einnehmen.

Erstellen der Erweiterung

• Verwenden Sie ein negatives Look-ahead-Regex, um den Session-Server und andere unnötige Einfügungen zu vermeiden: (?!/(login/sessionserver| (?!/(login/sessionserver|s.gif)
• Die Verwendung der "Oder"-Logik innerhalb des Pakets ist effizienter als die Erstellung zweier separater Erweiterungen
• "na"  kann  manchmal"ap,  "eu" oder "cs" sein, je nach geografischem Standort des Salesforce-Servers, aber es ändert sich im Allgemeinen nicht, bleiben Sie also bei der URL, die Sie haben.
  • nameansNorthAmerica,apmeansAsia-Pacific,andeumeansEurope, Middle East or Africa.csrepresents a sandbox environment
  • Die Nummer neben dem Code mit 2 Buchstaben gibt die Serverinstanz im zugeordneten Land an. Dies kann sich ändern, wenn Sie eine neue Umgebung hochladen oder eine bestehende Umgebung aktualisieren
  • Sie können den Gesundheitszustand des Salesforce-Server sehen unter  http://trust.salesforce.com/trust/instances

Testen der Erweiterung

• Bitten Sie das CSM, eine "schwere" Seite mit viel Inhalt oder alternativ eine wichtige Seite in der Implementierung bereitzustellen. Stellen Sie sicher, dass es dort gut funktioniert.
• Stellen Sie sicher, dass die Erweiterung nicht in zu vielen iFrames eingefügt wird. Verwenden Sie dabei das  Master Extension Diagnostics Tool.
  

Test

Produktion

In den obigen Beispielen werden Sie bemerken, dass wir (?!console) dem Salesforce Classic Regex hinzugefügt haben. Da diese Pakete innerhalb der gleichen Erweiterung liegen und die Classic- und Console-URLs ziemlich ähnlich sind, möchten wir nicht, dass WalkMe durcheinander kommt und WalkMe an einer Stelle geladen wird, wo es nicht geladen werden sollte (oder erst gar nicht geladen wird!). Der einzige Unterschied zwischen einer Classic- und Console-URL besteht darin, dass am Ende einer Console-URL "/console" steht. Wir fügen dem Salesforce Classic Regex also (?!console) hinzu, um sicherzustellen, dass es keinen Inhalt lädt, der für Salesforce Console bestimmt ist.

Workday®

Test

Produktion

SuccessFactors

Test

Produktion

Unterscheiden zwischen ähnlichen, aber kritisch differenzierten URLs

Bei der Konfiguration einer Erweiterung benötigen Sie oft mehrere Pakete für verschiedene Plattformen, z. B. eines für normales Salesforce (SFDC) und ein anderes für Service Cloud. In solchen Fällen wird Ihre Browser-Erweiterung Regex verwenden, um zwischen Plattformen zu unterscheiden und verschiedene Snippets in diese verschiedenen Plattformen je nach Bedarf einzufügen. Im SFDC Service Cloud könnten wir hypothetisch Regex verwenden, um zwischen diesen Plattformen wie folgt zu unterscheiden:

Normale SFDC-URL:

• https://cs2.salesforce.com/home/home.jsp?tsid=02u0000000000hV

Normale Service Cloud-URL:

• https://cs2.salesforce.com/console?tsid=02u50000000e56v

Regex-Anweisung für die Erweiterung, um eine beliebige Service Cloud-URL zu erfassen:

• .*cs2.salesforce.com/console.*

Dies konzentriert sich auf das Auftreten des Begriffs "Konsole" unmittelbar nach der salesforce.com Domä ne.

Da ein klarer Unterschied zwischen der Service-Cloud-URL und der SFDC-URL das Erscheinungsbild des Wortes "console" unmittelbar nach "salesforce.com" ist, können wir dies zu unserem Vorteil nutzen.

Mit den Regex-Symbolen "?!" können wir alle Instanzen von "salesforce.com" ausführen, die nicht vom Wort "console" gefolgt werden. Angesichts unserer beiden Basis-URLs wissen wir, dass es sich hierbei um SFDC-URLs handelt.

SFDC regex:

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

Hier bedeutet "?!console" eine URL, die die Elemente in diesem Regex besitzt, wobei "console" NICHT an dieser Position im Ausdruck angezeigt wird.

Dies entspricht nicht https://cs2.salesforce.com/console?tsid=02u500e56v, aber es entspricht https://cs2.salesforce.com/home/home.jsp?tsid=02u00hV.se