概要

WalkMe拡張機能を構成する際、regexを使用して、WalkMeがインジェクションするドメインを定義します。 この記事では、Salesforce、Workday、SuccessFactorsの一般的な正規表現ガイドラインと、プラットフォーム固有の例を説明します。

一般ガイドライン

具体的だが柔軟に

正規表現は、異なるページ間でも機能するようにしつつ、可能な限り具体的にする必要があります。 顧客固有のプレフィックスを使用して、このバランスを実現します。

各環境に異なる正規表現を使用します。

各環境には、独自の正規表現が必要です。 プレフィックスを使用して、本番環境とサンドボックスを区別します。

Always wrap regex with .*

すべてのregex文字列を.*で開始し、終了します

数字を.*に置き換えます

特定の数字を使用する代わりに、.*をその場所で使用します。

ピリオドは\でエスケープしてください

すべてのピリオドの前に、常に\を置いてください。

ハイフンをエスケープしないでください。

複数のプレフィックスには、（第一|第二）を使用します。

2つ以上の異なるプレフィックスを持つURLを含めるには、プレフィックスが発生する場所に（第一|第二|第三）を使用します。

単語を除外するには、ネガティブな先読みを使用します

特定の単語をマッチから除外するには、(？！word)を使用します。

複数のregexを|で組み合わせます。

パッケージに複数のregexを含めるには、各regexを|で区切り、スペースは入れないでください。

Regexは大文字と小文字を区別します。

常に、正規表現内のURLの大文字と小文字を正確に一致させてください。

Stricter Domain Regex

場合によっては、特定のiFrameに注入を制限し、WalkMeが同じドメインを参照する他のiFrameを読み込むのを防ぐ必要がある場合があります。

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

アプリ固有のRegex

Salesforce

Salesforce拡張機能は、ページ間の分散と分析iFrameの存在により、特別な注意が必要です。

拡張機能を作成する場合：

• セッションサーバーやその他の不要なインジェクションを避けるために、否定先読みを使用してください：（？！/（ログイン/sessionserver|s\.gif）
• 2つの独立した拡張機能を作成するのではなく、パッケージ内で「Or」ロジックを使用します
• サーバープレフィックス（「na」、「ap」、「eu」、「cs」）は通常同じままです。お持ちのURLをそのまま使用してください。

テスト環境

Salesforce Classic：

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

Salesforce Lightning：

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

Salesforceコンソール

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

本番環境

Salesforce Classic：

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

Salesforce Lightning：

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

Salesforceコンソール

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

Workday®

テスト：.*impl\.workday\.com/customername.*

本番：.*myworkday\.com/customername.*

SuccessFactors

テスト：.*hcm.*preview\.sapsf\.com.*

生産：.*performancemanager.*\.successfactors\.com.*

類似のURLを区別する

類似したURLを持つプラットフォーム（例：標準のSalesforceとSalesforce Service Cloud）の拡張機能を構成する場合、正規表現を使用してそれらを区別します。

通常のSFDC URL：https://cs2.salesforce.com/home/home.jsp?tsid=02u0000000000hV

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

違いは、salesforce.comの後に「コンソール」という単語が表示されることです。 これを有利に活用してください：

Service Cloud regex：

.*cs2.salesforce.com/console.*

SFDCの場合、否定先読みを使用して、salesforce.comの後に「console」が続くURLを除外します：

SFDC regex：

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

これは、https://cs2.salesforce.com/home/home.jsp に一致しますが、https://cs2.salesforce.com/consoleには一致しません。