Breve Visão Geral

Ao configurar uma extensão do WalkMe, você usa o regex para definir em quais domínios o WalkMe deve ser injetado. Este artigo aborda diretrizes gerais de regex e exemplos específicos de plataforma para Salesforce, Workday e SuccessFactors.

Diretrizes Gerais

Seja específico, mas flexível

O Regex deve ser o mais específico possível, mas ainda funcionar em páginas diferentes. Use prefixos específicos do cliente para alcançar esse equilíbrio.

Use regex diferente para cada ambiente

Cada ambiente deve ter seu próprio regex exclusivo. Use prefixos para diferenciar entre produção e sandbox.

Sempre envolva o regex com .*

Comece e termine cada string de regex com .*

Substitua números por .*

Em vez de usar dígitos específicos, use .* em vez disso.

Use \ para escapar pontos

Sempre coloque um \ antes de cada ponto.

Não escape hífens

Use (primeiro|segundo) para vários prefixos

Para incluir um URL com dois ou mais prefixos diferentes, use (primeiro|segundo|terceiro) onde os prefixos ocorrem.

Use o negative lookahead para excluir palavras

Para excluir uma palavra específica de uma correspondência, use (?!word).

Combine vários regex com |

Para incluir mais de um regex em um pacote, separe cada um com | e sem espaços.

Regex diferencia maiúsculas de minúsculas.

Sempre corresponda com exatidão ao URL no seu regex.

Regex de domínio mais rigoroso

Em alguns casos, pode ser necessário restringir a injeção a um iFrame específico e impedir que o WalkMe carregue outros iFrames que façam referência ao mesmo domínio.

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

Regex específico de aplicativos

Salesforce

As extensões do Salesforce exigem cuidado extra devido à variação entre as páginas e à presença de iFrames de análise.

Ao criar a extensão:

• Use lookahead negativo para evitar o servidor de sessão e outras injeções desnecessárias: (?!/(login/sessionserver|s\.gif)
• Use a lógica "ou" dentro de um pacote, em vez de criar duas extensões separadas
• O prefixo do servidor ("na", "ap", "eu", "cs") geralmente permanece o mesmo — siga o URL que você tem

Ambientes de teste

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.*

Ambientes de produção

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®

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

Produção: .*myworkday\.com/customername.*

SuccessFactors

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

Produção: .*performancemanager.*\.successfactors\.com.*

Distinguindo entre URLs semelhantes

Ao configurar extensões para plataformas com URLs semelhantes, por exemplo, Salesforce padrão e Salesforce Service Cloud, use regex para diferenciar entre elas.

URL normal do SFDC: https://cs2.salesforce.com/home/home.jsp?tsid=02u000000000hV

URL do Service Cloud: https://cs2.salesforce.com/console?tsid=02u5000000e56v

A diferença é a palavra "console" aparecer após salesforce.com. Use isso para sua vantagem:

Regex do Service Cloud:

.*cs2.salesforce.com/console.*

Para SFDC, use lookahead negativo para excluir qualquer URL onde "console" siga salesforce.com:

SFDC regex:

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

Isso corresponde a https://cs2.salesforce.com/home/home.jsp, mas não a https://cs2.salesforce.com/console.