フロー
概要
Avonni Flow コンポーネントは、Salesforce の Screen Flow を Avonni Dynamic Component のレイアウト内にシームレスに埋め込み、実行します。これはコンテナとして機能し、ガイド付きプロセス、インタラクティブなフォーム、および動的なユーザー体験(すべて Flow のロジックと自動化によって駆動される)を、視覚的に構築したカスタム Lightning ページ UI に直接統合できるようにします。
主な特長
インライン Screen Flow 実行:Screen Flow を Dynamic Component のレイアウトの一部として実行します。
データ統合:Dynamic Component からデータを渡します 各 入力変数を使って Flow に。
Flow 結果の取得:データを取得します から Flow からのデータを出力変数を使って Dynamic Component に返します。
Flow 動作の制御:埋め込まれた Flow が終了したときに何が起きるかを定義します。
起動と埋め込みの違い
次のような操作がある一方で「フロー ダイアログを開く」または「Open Flow Panel」は通常 Screen Flow を 別のモーダルやサイドパネルで起動します (通常はボタンクリックなどのユーザーアクションでトリガーされます)が、 Avonni Flow コンポーネント は Screen Flow を埋め込みます コンポーネントの現在のレイアウト領域内に直接。表示条件が満たされていれば、ページ構造の一部として可視かつアクティブです。
使用例
レコードやアプリページ上に動的なアンケートや調査を直接埋め込むこと。
より大きなカスタム UI の一部としてガイド付きのミニウィザードやチェックリストを表示すること。
Flow ロジックを活用したデータ入力や更新のためのインタラクティブなフォームを、ページの一部に直接作成すること。
複雑な Flow ロジックによって駆動される条件付きの UI 要素やメッセージをインラインで表示すること。
表示されているデータに関連するプロセスを開始するためのコンパクトでガイドされた方法を提供すること。
Flow コンポーネントの追加
ドラッグ&ドロップ:コンポーネントライブラリ(左パネル)から「Flow」コンポーネントを探し、Screen Flow を表示したいキャンバス上の場所にドラッグします。

構成
基本プロパティ
実際の:(テキスト)Dynamic Component 内でこの Flow コンポーネントのインスタンスを一意に識別するための識別子(例:
QuickContactUpdateFlow
,SurveyFlowEmbed
).Flow API 名:Salesforce の Name の Screen Flow に埋め込み、実行したいものを選択します。
入力変数(Flow へのデータ渡し)
このセクションでは、Dynamic Component(例:現在のレコード ID、ユーザーの選択、変数値)から選択した Screen Flow の入力変数にデータを渡すことができます。 各 選択した Screen Flow の入力変数に。
「入力変数を追加」(または同様の操作)をクリックします。
Name:ドロップダウンから、次のいずれかを選択します 実際の Screen Flow 内で定義されている入力変数の であり、 「入力可能(Available for Input)」としてマークされているもの。
Value:リソースセレクタ(
マッピング済み
) 動的コンポーネントからこのフローの入力変数に渡したい値を選択します。これには次のものが含まれます:静的な値。
グローバル変数(例:
@recordId
やselectedAccountId
動的コンポーネントに ターゲットページオブジェクト が設定され、レコードページ上にある場合)。動的コンポーネントの変数、定数、または数式リソース。
キャンバス上の別のコンポーネントからの属性(例:
!MyDataTable.firstSelectedRow.Id
).
出力変数(フローからのデータ取得)
このセクションでは、スクリーンフローの出力変数(「出力可能」とマークされたもの)から値を取得し、動的コンポーネント内の変数リソースに格納できます。
「出力変数を追加」(または類似の操作)をクリックします。
出力名:ドロップダウンから、次のいずれかを選択します 実際の 定義された出力変数の であり、 で「出力可能」とマークされたもの。
リソース名:選択する 変数リソース (一致するデータ型の)フローの出力変数が返す値を格納するために、動的コンポーネントから選択する場所。
フローの動作制御
終了動作:(選択)埋め込まれたスクリーンフローが「終了」画面または終了点に達したときに自動的に何が起こるかを定義します。
なし
(デフォルト):フローは一度実行されます。終了後、通常は最後の画面に留まるか、完了状態になります。再起動
:フローが終了した後、自動的に最初から再起動します。循環的なデータ入力やキオスクのようなシナリオで有用です。
になります。次の場合: あなたの LWC が
フローコンポーネント全体(および埋め込まれたフロー)がページ上で表示されるかどうかを制御します。詳細は になります。次の場合: あなたの LWC が.
例: ケースページに「タスクを素早く更新」フローを埋め込む
結果: 「クイック更新タスク」フローはケースページに直接埋め込まれ、ケースIDが事前に読み込まれるため、ユーザーはそのケースのタスクを迅速に追加または更新できます。
重要な考慮点
スクリーンフローのみ: このコンポーネントは スクリーンフローを実行するように設計されています。オートローンチされたフローは「フローを実行」インタラクションを介してトリガーする必要があります。
フローのUIは別管理: フローの画面の視覚的デザイン(要素、レイアウト、および使用されるAvonniコンポーネント フロー用 で カラム内で それらの画面)はSalesforce Flow Builderで管理されます。ここでのフローコンポーネントはそれをホストします。
フローの制限: 埋め込まれたフローは引き続き標準のSalesforceフロー制限およびガバナー制限の対象となります。
コンテキスト: ダイナミックコンポーネントによって提供されるコンテキスト内でフローが実行されること、特に入力変数に関して忘れないでください。
埋め込みフローの読み込み時間: 埋め込まれたスクリーンフローが表示され対話可能になるまでの時間に注意してください は、Salesforceのフローレンダリングエンジンおよび特定のフローの複雑さ(例:要素数および 初期データクエリ カラム内で フロー)の影響を受けます。周囲のAvonniダイナミックコンポーネントおよび全体のLightningページは迅速に読み込まれますが、非常に複雑な埋め込みフローは初期化に少し時間がかかる場合があります 割り当てられた領域内で。これは主にフロー自身の起動時間に影響を与え、ページ上の他のコンポーネントのパフォーマンスを低下させるべきではありません。
まとめると
Avonniフローコンポーネントは、ダイナミックコンポーネントで構築されたカスタムLightningページUIに対して、対話型のSalesforceスクリーンフローを直接埋め込む強力な方法を提供します。これにより、シームレスなデータ交換が可能になり、宣言的なページ設計の利点と案内型プロセス自動化の強みを組み合わせることができます。
最終更新
役に立ちましたか?