フロードイアログを開く

概要

「Open Flow Dialog」インタラクションは、Avonni ダイナミックコンポーネント内から直接 Salesforce の Screen Flow をモーダルダイアログウィンドウで起動できるようにします。これにより、ユーザーが現在のページから離れることなく、対話型の複数ステップのプロセスをユーザーインターフェースに組み込む強力な方法が提供されます。

使用例

「Open Flow Dialog」インタラクションは、Screen Flow をダイナミックコンポーネント内に埋め込みます。これは次のようなシナリオに最適です：

• 複雑なプロセスをユーザーに案内する。

• 情報を構造化された方法で収集する。

• ユーザーの入力に基づいて一連の画面を表示する。

• ユーザーの操作を必要とするアクションを実行し、 前に メインコンポーネントのロジックを続行する。

(重要な違い： UI を伴う Screen Flows には「Open Flow Dialog」を使用してください。別の「フローを実行」インタラクションを使用して Autolaunched Flows をバックグラウンドで実行します。）

チュートリアル

このインタラクションを使った具体的なシナリオの実例と実装方法は次をご覧ください：

Dynamic Component から Screen Flow に複数の選択レコードを渡す方法

---

仕組み

1. ユーザーのアクション： ユーザーがコンポーネントとやり取りします（例：ボタンをクリック）。

2. ダイアログが開く： 「Open Flow Dialog」インタラクションがモーダルダイアログウィンドウを開きます。

3. Screen Flow の実行： 指定された Screen Flow が実行されます カラム内で ダイアログウィンドウ内で。

4. Flow とのユーザーのやり取り： ユーザーは Screen Flow の画面とやり取りし、入力を行い選択をします。

5. データ受け渡し（オプション）： ダイナミックコンポーネントから Flow にデータを 入力変数.

6. として渡すことができます。 出力（オプション）： Flow はダイナミックコンポーネントにデータを.

7. 出力変数 として返すことができます。

8. ダイアログが閉じる： Flow が終了するか（またはユーザーがダイアログを閉じると）モーダルウィンドウが閉じます。

---

構成

実行後のアクション（オプション）：

1. Flow が終了した後に発生するアクションを設定できます（例：トーストメッセージの表示、データの更新）。 「Open Flow Dialog」インタラクションを設定するには：

2. コンポーネントを選択： Flow をトリガーする Avonni コンポーネントを選択します（例：ボタン）。

3. インタラクションを追加：

   • フロー API 名: コンポーネントのプロパティパネルで「Actions」または「Interactions」の設定セクションを見つけます。新しいアクションを追加し、「Open Flow Dialog」タイプを選択します。 Screen Flow 設定を構成：

   • フロー入力変数（任意）:

     • 起動したい の API 名を選択します。

     • 値： 名前：

重要

Screen Flow 内の入力変数の API 名。

• 出力変数（任意）:

  • 起動したい 入力変数に渡したい値です。これは静的な値、コンポーネントからの動的な値（例：選択された行の ID）、またはリソースにすることができます。

  • このリストには、既に Screen Flow 内で定義され「Available for Input」にマークされた変数が表示されます。Open Flow Dialog インタラクションを設定する前に、これらの入力変数を Flow 内で作成する必要があります。Value には選択した入力変数に渡したい値を指定してください。 Screen Flow 内の出力変数の API 名。 Dynamic Component リソース名：

• Flow が返す値を格納したい 内のリソース（変数）の名前。

• モーダルヘッダー： ダイアログウィンドウのタイトルとして表示するテキスト。静的テキストやリソース／フィールドからの動的値にできます。

• サイズ： アクセシブル記述：

• （オプション）スクリーンリーダーのための説明を提供し、アクセシビリティを向上させます。 ダイアログウィンドウのサイズを選択します（Small、Medium、Large）。 完了時（オプション）：Flow が正常に完了したときに発生するアクションを設定します

• （成功時） 。日常的なユースケースにはトーストメッセージの表示やデータのリフレッシュが含まれます。 閉じたとき（オプション）： ユーザーがダイアログウィンドウを

• 閉じたときに発生するアクションを設定します（Flow が終了したかどうかにかかわらず）。 エラー発生時（オプション）： Flow が.

---

エラー

に遭遇した場合に発生するアクションを設定します。

1. 使用例：アカウントから連絡先を作成する

   • Avonni のデータテーブルにアカウントが表示されているとします。各行にボタンを追加し、クリックすると関連する新しい連絡先を作成する Screen Flow が開くようにしたい場合の例です。

   • Screen Flow を作成する AccountId Salesforce の設定で新しい Screen Flow を作成します。

   • という名前の入力変数を追加します

   • （Text タイプ）。 AccountId 連絡先情報（名、姓、メールなど）を収集する画面要素を追加します。 AccountId 新しい連絡先を作成するために「Create Records」要素を追加し、

   • フィールドを

   • 入力変数の値に設定します。

2. （オプション）たとえば作成された連絡先の ID を返すための出力変数を追加します。 Flow を有効化します。Flow の API 名をメモしてください。

3. データテーブルコンポーネントを追加： ダイナミックコンポーネントに Avonni データテーブルコンポーネントを追加し、アカウントを表示するように設定します。

4. ボタンを追加（行アクション）：

   • データテーブルの行アクションとしてボタンコンポーネントを追加します。

   • 「Open Flow Dialog」インタラクションを設定

   • フロー API 名: ボタンコンポーネント（行アクション）を選択します。

   • 「Open Flow Dialog」インタラクションを追加します。

     • 起動したい AccountId

     • 値： Screen Flow の API 名を入力します。 Flow の入力変数：

   • Flow が返す値を格納したい レコード：アカウント ID

   • （これは選択されたアカウントの ID を Flow に渡します）。 「Create new Contact」に設定する

5. 完了時： 連絡先作成を確認するための「Show Toast」アクションを追加し、クエリテーブルをリフレッシュして新しい連絡先が表示されるようにします。

---

変数が更新され、それらの値を使用してデータテーブルをフィルタリングできます。

• テスト： 保存してテストします。データテーブルの行のボタンをクリックすると、ダイアログで Screen Flow が開き、アカウント ID が事前入力されているはずです。 Screen FlowsScreen Flows のみ：

• 「Open Flow Dialog」インタラクションは と互換性があり、オートローンチされたフローでは動作しません。 必ず 入力／出力変数名：

• 入力および出力変数の API 名は Flow と「Open Flow Dialog」の設定間で厳密に一致する必要があります。

---

まとめると

モーダルの動作：