完了動作を制御するようにフロー URL をカスタマイズ
デフォルトでは、ユーザーが画面フローを完了すると、画面フローによってユーザーは最初の画面にリダイレクトされます。ユーザーが [完了] をクリックしたら Salesforce 内の別のページにリダイレクトされるように設定するには、フロー URL に retURL パラメーターを使用します。
必要なエディション
| サポートされているエディションを表示する。 |
形式
[完了] をクリックした後に画面フローのユーザーを Salesforce の特定のページにリダイレクトするには、次の形式を使用します。
/lightning/flow/flowName?retURL=urlURL は相対 URL です(https://MyDomainName.my.salesforce.com/ または https://MyDomainName.Lightning.Force.com/ の後の部分)。
次に例を示します。
- カスタマイズする画面フローを作成または識別します。
- 最後の画面で [完了] をクリックした後のフローでのユーザーのリダイレクト先 URL を決定します。
- フロー URL に
?retURL=urlを追加します。ここで、 url はリンク先ページの相対 URL です。 - 入力変数もフローに渡す場合は、変数パラメータの後に retURL パラメータを
&で区切って追加します。例:/lightning/flow/MyFlow?flow__varCaseId=500xx000000abc&retURL=lightning/page/home - 完全な URL をボタン、リンク、またはコンポーネントで retURL パラメーターと共に使用します。
URL オプション
フローユーザーを次の Salesforce URL にリダイレクトします。
| リダイレクト先 | 相対 URL | 例 |
|---|---|---|
| Chatter | _lighnting/page/chatter/ | lightning/page/chatter/ui/ChatterPage |
| ホームページ | Lightning/page/home | Lightning/page/home |
| リストビュー | ライティング環境: o/object_name/list?filterName=API_name 固定表示リストビュー: Lightning/o/object_name/list Classic: objectCode?fcf=listViewId |
Lightning Experience: Lightning/o/Case/list?filterName=MyCases Classic: 006?fcf=00BD0000005lwec |
| 取引先ホームなど、オブジェクトのホームページ | objectCode/o | 001/o |
| 取引先責任者、レポート、ダッシュボード、ユーザー、プロファイル、Chatter 投稿など、固有のレコード | recordId | 0D5B000000SKZ7V |
| Visualforce ページ | apex/pageName | apex/myVisualforcePage |
| Web タブ | servlet/servlet.Integration?lid=webTabId | servlet/servlet.Integration?lid=01rD0000000A88h |
- オブジェクトコードは、Salesforce の標準オブジェクトとカスタムオブジェクトを識別する 3 桁のプレフィックスです。URL またはオブジェクトの詳細でオブジェクトのレコード ID プレフィックスを確認します。たとえば、取引先オブジェクトではプレフィックス
001、ケースオブジェクトでは500、商談オブジェクトでは006を使用します。または、オブジェクト種別のテストレコードを作成し、レコード ID の最初の 3 文字を調べます。 オブジェクトコードは、この 3 文字と一致します。 - Salesforce Classic の URL の場合、Salesforce はユーザーを有効化した Salesforce 環境 (Lightning Experience または Salesforce Classic) の適切なページにリダイレクトします。ページが Lightning Experience に存在しない場合、ユーザーは Salesforce Classic のページにリダイレクトされます。
- Lightning Experience の URL では、ユーザーは、Salesforce Classic を有効にしていても、Lightning Experience のホームページ (
lightning/page/home) に常にリダイレクトされます。Lightning Experience にアクセスする権限がないユーザーには、エラーメッセージが表示されます。 - Lightning Experience の Web タブでは、Visualforce ページにのみリダイレクトできます。
- URL でレコード ID (
flow__varCaseId=500xx000000abcなど) を渡す場合、動作はフローのフロー変数の型によって異なります。- テキスト変数の場合、Salesforce はレコード ID をテキスト文字列として渡します。フローは ID 値 (
500xx000000abcなど) を受け取ります。 - レコード変数の場合、Salesforce はレコードオブジェクト全体を渡そうとします。ただし、URL でレコード ID を渡しても、自動的に完全なレコードが読み込まれるわけではありません。フローは ID を受け取りますが、フローで [レコードを取得] 要素を使用して、その ID に基づいて完全なレコードデータを取得する必要があります。
- ID のみを渡すレコード変数で、指定されていないレコード項目が想定される場合、フローが失敗する可能性があります。レコード ID を受信したら、必ず [レコードを取得] 要素を使用して、レコード変数に必要な項目を入力します。
- テキスト変数の場合、Salesforce はレコード ID をテキスト文字列として渡します。フローは ID 値 (
制限事項
- Salesforce 組織の外部 URL にフローユーザーをリダイレクトすることはできません。
- retURL パラメーターの値としてフロー変数を使用することはできません。フロー変数を使用して特定のレコードなどにユーザーをリダイレクトするには、Visualforce を使用してフローを配布します。
- retURL を使用すると、ネストされた上部と横のナビゲーションバーが宛先ページに表示される可能性があります。
- フロー URL の先頭に
/lightningを追加しない場合、retURL では大文字と小文字が区別されます。retUrl を使用した場合、その URL でユーザーはリダイレクトされません。 - アクションボタン画面コンポーネントでは、retURL パラメーターはサポートされません。
例
ケースオブジェクトのボタン URL をカスタマイズする前に、ボタンでフローが起動します。ユーザーがフローを終了すると、フローの最初の画面にリダイレクトされます。
/lightning/flow/Case_Update_Flow次に、ユーザーがフローを終了した後にケースリストビューにリダイレクトするようにボタン URL をカスタマイズします。
/lightning/flow/Case_Update_Flow?retURL=500/oボタンをカスタマイズする
- [設定] で [オブジェクトマネージャー] をクリックします。
- [ケース] をクリックし、[ボタン、リンク、およびアクション] をクリックします。
- カスタムボタンを見つけて、[編集] をクリックします。
- URL フィールドで、フロー URL の最後に ？retURL＝500/o を追加します。メモ
500はケースのオブジェクトコードです。 - [保存] をクリックします。
次のフロー URL により、ユーザーは取引先ホームにリダイレクトされます。これは、Lightning Experience と Salesforce Classic の両方に存在します。
/lightning/flow/myFlow?retURL=001/o Lightning Experience ユーザーがフローインタビューを完了すると、Salesforce によって http://MyDomainName.lightning.force.com/lightning/o/Account/home にリダイレクトされます。Salesforce Classic ユーザーがフローインタビューを完了すると、Salesforce によって http://MyDomainName.my.salesforce.com/001/o にリダイレクトされます。どちらの場合でも、ユーザーはそれぞれの環境の取引先ホームにリダイレクトされます。
次のフロー URL では、ユーザーは Salesforce Classic にのみ存在する Visualforce ページにリダイレクトされます。
/flow/myFlow?retURL=apex/myPageユーザーがフローインタビューを完了すると、Salesforce Classic の http://MyDomainName.my.salesforce.com/apex/myPage にリダイレクトされます。ユーザーが Visualforce ページから離れると、Salesforce は元の環境に戻ります。
たとえば、Visualforce ページを表示した後、ユーザーはホームページに移動します。Lightning Experience ユーザーの場合は、Lightning Experience のホームページ (http://MyDomainName.lightning.force.com/lightning) が表示されます。Salesforce Classic ユーザーの場合は、Salesforce Classic のホームページ (http://MyDomainName.my.salesforce.com/home/home.jsp) が表示されます。
次のフロー URL により、varUserFirst および varUserLast 変数 (どちらもテキスト型) が実行ユーザーの FirstName および LastName 項目値に設定されます。フローインタビューが完了すると、ユーザーは有効化された Salesforce 環境のホームページにリダイレクトされます。
/lightning/flow/User_Info?flow__varUserFirst={!$User.FirstName}
&flow__varUserLast={!$User.LastName}&retURL=home/home.jsp