フローを実行

フローの実行インタラクション

"Execute Flow" インタラクションは、Avonni ダイナミックコンポーネント内から直接 自動起動 Salesforce Flow を起動することを可能にします。これにより、ユーザーが現在のページを離れることなく、インターフェースに自動化やビジネスロジックを統合する強力な手段が提供されます。

概要

Execute Flow インタラクションは、コンポーネント内のユーザー操作からバックグラウンドプロセス（自動起動フロー）をトリガーする方法です。これはタスクの自動化、レコードの更新、計算の実行、またはフロー内でのその他のロジック実装に役立ちます。

対応コンポーネント

以下の Avonni ダイナミックコンポーネントに "Execute Flow" インタラクションを追加できます：

• ボタン

• ボタングループ

• Button Menu

• アイコンボタン

• データテーブル（ヘッダーアクション）

• リストアイテム

重要な注意点

"フローを実行" インタラクションは 自動起動 バックグラウンドで実行される フロー （ユーザーインターフェース要素を持つフロー）を起動したい場合は、"Open Flow Dialog"" または "Open Flow Panel" インタラクションを代わりに使用してください

仕組み

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

2. フローの実行： "Execute Flow" インタラクションが指定された自動起動フローをトリガーします。

3. データの受け渡し（任意）： コンポーネントからフローへデータを 入力変数.

4. フロー処理： フローはロジックを実行し、入力変数を使用する場合があります。

5. 出力（任意）： フローはデータを 出力変数.

6. 実行後のアクション（任意）： フロー完了後に発生するアクションを設定できます（例：成功またはエラー時にトーストメッセージを表示）。

構成

"Execute Flow" インタラクションを設定するには：

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

2. インタラクションを追加： コンポーネントのプロパティパネルで「アクション」または「インタラクション」を設定するセクションを見つけます。新しいアクションを追加し、"Execute Flow" タイプを選択します。

3. 設定を構成：

   • フロー API 名: 実行したい 自動起動 フローの API 名を選択します。これはフローの一意の識別子です。

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

     • フローにデータを渡すには 各 ここにエントリを追加します。

     • 各入力変数について：

       • 名前： ホストされている画像の 正確な フローで定義された入力変数の API 名。

       • 値： 渡したい値を選択します。これは次のいずれかです：

         • 静的な値（例："New"）。

         • コンポーネントからの動的値（例：選択された行の ID）。

         • リソース。

   • 出力変数（任意）:

     • データをキャプチャするには から ここにエントリを追加します。

     • 各出力変数について：

       • 名前： ホストされている画像の 正確な フローで定義された出力変数の API 名。

       • リソース名： この値を使用できるあなたの Dynamic Componentでのリソース名を入力します。

   • 完了時（任意）： フローが完了したときに発生するアクションを設定します 正常に。. 日常的な使用例として、連絡先の更新を確認するために「Show Toast」アクションを表示することが挙げられます。

   • エラー時（任意）： フローが エラーに遭遇した場合に発生するアクションを設定します。日常的な使用例として、ユーザーに知らせるために「Show Toast」アクションを表示することが挙げられます。

ステップバイステップの例：連絡先の更新

クリックすると自動起動フローを使って連絡先のステータスを「Active」に更新するボタンを作成するとします。

1. 自動起動フローを作成：

   • Salesforce 設定で新しい自動起動フローを作成します。

   • 次の名前の入力変数を追加します： ContactId （テキスト型）。

   • 一致する連絡先を取得するために「レコード取得（Get Records）」要素を追加します： ContactId.

   • 連絡先の ステータス フィールドを「Active」に更新するために「レコード更新（Update Records）」要素を追加します。

   • 出力変数を追加（任意）。

   • フローを有効化します。フローの API 名をメモしてください。

2. ボタンコンポーネントを追加： ダイナミックコンポーネントに Avonni ボタンコンポーネントを追加します。

3. "Execute Flow" インタラクションを構成：

   • ボタンコンポーネントを選択します。

   • "Execute Flow" インタラクションを追加します。

   • フロー API 名: 自動起動フローの API 名を入力します。

   • フロー入力変数：

     • 名前： ContactId

     • 値： @ThisItem.Id （これはボタンがデータテーブルやリストなどの繰り返しコンポーネント内にあることを想定しており、 Id が連絡先 ID を含むフィールドであるとします。必要に応じて調整してください。）

   • 完了時のアクション：

     • 連絡先の更新を確認するために「Show Toast」のようなメッセージを表示するアクションを追加します。

4. テスト：保存してテストします。

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

• 自動起動フローのみ: "Execute Flow" インタラクションは 自動起動 フロー（Screen Flow ではなく）でのみ機能します。

• 入力／出力変数の名前： 入力および出力変数の API 名は、フローと "Execute Flow" の設定間で厳密に一致する必要があります。 必ず 実行中に発生する可能性のあるエラーを適切に処理するために、"On Error" アクションを使用してください。

• エラーハンドリング： データ型：

• 入力および出力変数のデータ型がフローとコンポーネント間で一致していることを確認してください。 「Execute Flow」インタラクションは、ダイナミックコンポーネントから自動起動フローを追加するための有用な機能です。設定には、トリガーするフローの指定、入出力変数、完了時／エラー時のアクションの設定が含まれます。

まとめると

Execute Flow インタラクションは、ダイナミックコンポーネントから自動起動フローを追加するための貴重な機能です。設定には、実行するフローの指定、入出力変数、および完了時／エラー時のアクションが含まれます。