フローダイアログを開く
概要
「Open Flow Dialog」インタラクションは、Avonni Dynamic Component 内からモーダルダイアログウィンドウで Salesforce のフローを直接起動できるようにします。 画面フロー これにより、ユーザーが現在のページから移動することなく、対話型の複数ステップのプロセスをユーザーインターフェースに組み込む強力な方法が提供されます。
ユースケース
「Open Flow Dialog」インタラクションは、Screen Flow を Dynamic Component 内に埋め込みます。これは次のようなシナリオに最適です:
ユーザーを複雑なプロセスに案内する。
構造化された方法で情報を収集する。
ユーザー入力に基づいて一連の画面を提示する。
メインコンポーネントのロジックを 継続する 前にユーザーの操作を実行する。
(主な違い: UI を伴う Screen Flow には「Open Flow Dialog」を使用してください。 Screen Flow を使用します。別の「Execute Flow」インタラクションを使って Autolaunched Flow をバックグラウンドで実行します。)
チュートリアル
このインタラクションを使用して特定のシナリオを実装する方法や実践的な例について学んでください:
Dynamic Component から Screen Flow に複数選択レコードを渡す方法仕組み
ユーザー操作: ユーザーがコンポーネントと対話します(例:ボタンをクリック)。
ダイアログが開く: 「Open Flow Dialog」インタラクションはモーダルダイアログウィンドウを開きます。
Screen Flow が実行される: 指定された Screen Flow が実行されます 内で ダイアログウィンドウ。
Flow とユーザーの対話: ユーザーは Screen Flow の画面と対話し、入力を行い選択をします。
データの受け渡し(オプション): Dynamic Component から Flow にデータを渡すことができます(例: 入力変数.
出力(オプション): Flow は Dynamic Component にデータを返すことができます(例: 出力変数.
ダイアログが閉じる: Flow が終了する(またはユーザーがダイアログを閉じる)とモーダルウィンドウは閉じます。
実行後のアクション(オプション): Flow が終了した後に実行するアクションを設定できます(例:トーストメッセージの表示、データの更新)。
設定
「Open Flow Dialog」インタラクションを設定するには:
コンポーネントを選択: Flow を起動する Avonni コンポーネント(例:ボタン)を選択してください。
インタラクションを追加: コンポーネントのプロパティパネルで「アクション」または「インタラクション」の設定セクションを探します。新しいアクションを追加し、種類として「Open Flow Dialog」を選択します。
設定を構成:
フローの API 名: 実行したい 画面フロー 起動したいフローを指定します。
フロー入力変数(オプション):
名前: Screen Flow 内の入力変数の API 名。
値: 入力変数に渡したい値。これは静的値、コンポーネントからの動的値(例:選択された行の ID)、またはリソースにすることができます。
重要
このリストは、すでに Screen Flow 内で定義され「入力用に利用可能」とマークされた変数を表示します。Open Flow Dialog インタラクションを設定する前に、これらの入力変数を Flow 内に作成する必要があります。値には、選択した入力変数に渡したい値を指定してください。
出力変数(オプション):
名前: Screen Flow 内の出力変数の API 名。
リソース名: Flow が返す値を格納したい Dynamic Component 内のリソース(変数)の名前。
モーダルヘッダー: ダイアログウィンドウのタイトルとして表示するテキスト。これは静的テキストまたはリソース/フィールドからの動的値にできます。
アクセシブル説明: (任意)スクリーンリーダー向けに説明を提供してアクセシビリティを向上させます。
サイズ: ダイアログウィンドウのサイズを選択します(Small、Medium、Large)。
完了時(オプション): Flow 完了時に発生するアクションを設定します 成功時。日常的なユースケースには、トーストメッセージの表示やデータの更新があります。
閉じる時(任意): ユーザーが 閉じたときに発生するアクションを設定します (Flow が完了したかどうかに関わらず)。
エラー時(オプション): Flow がエラーに直面した場合に発生するアクションを設定します エラー.
使用例:アカウントから連絡先を作成する
Avonni のデータテーブルにアカウントが表示されているとします。各行にボタンを追加し、そのボタンがクリックされると関連する新しい連絡先を作成する Screen Flow を開くようにしたい場合の例です。
Screen Flow を作成する
Salesforce の設定で新しい Screen Flow を作成します。
ContactId という名前の入力変数を追加します(
AccountId(テキスト型))。連絡先情報(名、姓、メールなど)を収集するための画面要素を追加します。
新しい連絡先を作成するために「Create Records」要素を追加し、
AccountIdフィールドをAccountId入力変数の値に設定します。(任意)例えば、新しく作成された連絡先の ID を返すための出力変数を追加します。
フローを有効化します。フローの API 名をメモしてください。
データテーブルコンポーネントを追加: Dynamic Component に Avonni Data Table コンポーネントを追加し、アカウントを表示するように設定します。
ボタンを追加(行アクション): データテーブルに行アクションとしてボタンコンポーネントを追加します。
「Open Flow Dialog」インタラクションを設定する
ボタンコンポーネント(行アクション)を選択します。
「Open Flow Dialog」インタラクションを追加します。
フローの API 名: Screen Flow の API 名を入力します。
フロー入力変数:
名前:
AccountId値:
レコード:アカウント ID(これは選択されたアカウントの ID を Flow に渡します)。
モーダルヘッダー: 『新しい連絡先を作成』に設定
完了時: 連絡先作成を確認するために「Show Toast」アクションを追加し、クエリテーブルを更新して新しい連絡先が表示されるようにします。
テスト: 保存してテストします。データテーブルの行のボタンをクリックすると、Account ID が事前に入力された状態でダイアログ内に Screen Flow が開くはずです。
重要な考慮事項
Screen Flow のみ: 「Open Flow Dialog」インタラクションは Screen Flowではなく、オートローンチされたフローでは動作しません。
入力/出力変数名: 入力および出力変数の API 名は 厳密に Flow と「Open Flow Dialog」設定の間で厳密に一致する必要があります。
モーダルの挙動: Flow はモーダルダイアログウィンドウ内で実行されます。ユーザーはページの他の部分と操作する前に Flow を完了するか閉じる必要があります。
まとめ
「Open Flow Dialog」インタラクションは、Avonni Dynamic Component 内で Screen Flow を直接起動するための強力なツールです。複雑な複数ステップのプロセスをアプリケーションにユーザーフレンドリーに統合できます。入力および出力変数を慎重に設定することで、コンポーネントと Flow 間のシームレスな連携を作成できます。
最終更新
役に立ちましたか?
