> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md).

# フローを実行

Avonni コンポーネントから、ダイアログを開いたりページを離れたりせずに、Salesforce の自動起動フローをバックグラウンドで実行します。

## 概要

「Execute Flow」インタラクションは、ユーザーが Experience Site 上のコンポーネントを操作したときに自動起動フローを開始します — ボタンのクリック、行アクション、ヘッダーアクション、リスト内の項目などです。画面上には何も開きません。フローはサーバー側で実行され、処理（レコードの更新、値の計算、別システムへの呼び出し）を行い、ユーザーがいるページはそのままの状態に保たれます。

他のインタラクションと同じように設定します。Experience Builder には Interactions タブがないため、設定は、接続しているイベントのエディタ内にあります — ボタンの **クリック時**、行アクションの **クリック時**、列ヘッダーアクションの **クリック時** — ここで選択するのは **Execute Flow** インタラクションとして **種類**.

{% hint style="warning" %}
**Execute Flow** 実行します *自動起動* フローのみです。画面フロー — ユーザーインターフェースを持つフロー — を起動するには、 [Open Flow Dialog](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md) または [Open Flow Panel](/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-panel.md) を使用してください。
{% endhint %}

これら 2 つのインタラクションとは異なり、フローをサイトのページ上に配置する必要はありません。Execute Flow はサーバー側でフローを開始するため、サイトのページでホストされることはなく、見つけるために何かを公開する必要もありません。

{% hint style="info" %}
**Execute Flow は Experience Builder でもサイトのプレビューでも実行されません。** そこでトリガーすると、「プレビューではインタラクションは実行されません」と表示するトーストが出て、フローはスキップされます。公開済みサイトでテストしてください。
{% endhint %}

## 設定

| 名前            | 説明                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| **フロー API 名** | 実行するフローです。リストには、組織内の自動起動フローが、その **ラベル**API 名ではなくラベルで表示され、検索もできます。まずこれを設定してください。これが設定されるまで、下の 3 つの設定は非表示のままです。 |
| **フロー入力変数**   | フローの開始前に渡される値です。変数ごとに 1 件ずつ指定します。詳細は下記を参照してください。                                                              |
| **完了時**       | フローが正常に完了した後に実行するインタラクションです。使用できるインタラクションは **トーストを表示** と **すべてのクエリを更新**.                                      |
| **エラー時**      | フローが失敗した場合に実行するインタラクションです。使用できるインタラクションは **トーストを表示** と **すべてのクエリを更新**.                                        |

### フロー入力変数

各エントリはフローの入力変数の 1 つに対応します。その変数は Flow Builder で **入力可能** に設定されている必要があり、API 名は大文字と小文字を区別します。

* **名前:** 設定するフロー変数です。リストには選択したフローの入力変数が表示されます。
* **値:** 割り当てる値です。この入力で選べる内容は、使用しているエディタによって異なります。行または項目のエディタ — Data Table の行アクション、リスト項目、ツリーグリッドの列ヘッダーアクション — では、 **カスタム** を選んで固定値を入力するか、その時点でコンポーネントが提供するレコードフィールドの 1 つを選択できます。すると `{{Record.<Field>}}` トークンが挿入され、各行または各項目がそれぞれの値を渡せるようになります。これらのフィールドオプションはコンポーネントの **クエリ** データソースから取得されます。Button、Banner、Metric、およびヘッダーアクションのエディタでは、クリックの背後にレコードがないため、 **値** はプレーンテキスト入力です。
* **種類:** 値のデータ型 — **テキスト** （既定） **数値**, **真偽値**, **日付**, **日時** または **Salesforce オブジェクト**。必要に応じて **カスタム** 一覧にない型を入力してください。
* **オブジェクト API 名:** 値が表すオブジェクト。たとえば `Account` または `Contact`。これは **種類** にする必要があります **Salesforce オブジェクト**.
* **複数値を許可（コレクション）:** 値が単一ではなくコレクションの場合は、これをオンにします。

のみ **名前** と **値** がフローに送信されます。 **種類**, **オブジェクト API 名** と **複数値を許可（コレクション）** コンポーネントに値を説明して、呼び出し前にトークンを解決できるようにするだけです。フローに何かを伝えるものではなく、Flow Builder で変数がどのように宣言されているかとの不一致を修正することもできません。

### 完了時とエラー時

**完了時** では、何が起きたかをユーザーに知らせ、ページを最新の状態にするための設定を行います — 例えば **トーストを表示** 操作を確認する **すべてのクエリを更新** ことで、ページ上のコンポーネントがフローで変更されたレコードを再読み込みします。

**エラー時** は逆の場合を扱います。ここで何も設定しない場合、 **トーストを表示** コンポーネントは独自のエラートースト「Error while executing the flow」を表示し、よくある 2 つの原因、つまりフローがアクティブでないか、実行しているユーザーにアクセス権がないことを示します。

## 例

Data Table にポータルユーザーが開いているケースが一覧表示されており、そのケースをサポートキューに割り当てる行アクションを作成したいとします。

1. Flow Builder で、自動起動フローを作成します — ラベルは `ケースをエスカレート`、API 名 `Escalate_Case` — テキスト入力変数 `recordId` を指定して **入力可能**、ケースのステータスとキューを設定する Update Records 要素を追加し、保存して有効化します。
2. Experience Builder で Data Table を選択し、列をマップして **種類** を設定 **アクション**。その下の **行アクション**に、次の内容でエントリを追加します。 **ラベル** の `エスカレート` と **名前** の `escalate`.
3. そのアクションの **クリック時**では **種類** を **Execute Flow** に設定し、選択します **ケースをエスカレート** で **フロー API 名** — リストには各フローのラベルが表示されます。
4. その下に **フロー入力変数**、1 件追加します: **名前** `recordId`, **値** **レコード: ケース ID**, **種類** **テキスト**。これらの **値** オプションは、テーブルのクエリのフィールドラベルにちなんで名付けられています。
5. その下に **完了時**、次を追加します **トーストを表示** （「ケースはエスカレートされました」）と **すべてのクエリを更新** これにより、テーブルが新しいステータスで再読み込みされます。

クリックすると **エスカレート** 行で、そのケースに対してフローが実行され、途中にダイアログは表示されません。

## トラブルシューティング

**Flow Input Variables の下の Name リストが空です。** フローがアクティブではありません。 **フロー API 名** 非アクティブなフローもアクティブなフローと並んで一覧に表示されますが、入力変数はフローのアクティブ版から読み取られます。非アクティブなフローにはそれがないため、提供できるものがありません。Flow Builder でフローを有効化してから、エディタを再度開いてください。

**builder またはサイトプレビューでインタラクションを試しても何も起こりません。** それは想定どおりです。そこで Execute Flow はスキップされ、その旨のトーストが表示されます。サイトを公開し、サイトユーザーとして試してください。

**自分ではフローが実行されるのに、サイトユーザーでは実行されません。** サイトのゲストユーザーまたはポータルユーザーのプロファイルが、フロー本体と、読み書きするレコードへのアクセス権を持っていることを確認してください。

## 重要な考慮事項

* **フローはアクティブである必要があります。** 非アクティブなフローは、サイトユーザーがトリガーすると失敗しますが、ビルダーでは何の警告も出ません。
* **サイトユーザーにはフローへのアクセス権が必要です** また、そのフローが操作するレコードへのアクセス権も必要です。管理者としては実行できるフローでも、ゲストユーザーやポータルユーザーでは失敗することがあります。
* **変数名は完全に一致している必要があります** フローとインタラクションの間で、大文字小文字も含めて
* **出力変数はありません。** Experience Sites では、インタラクションがフローから値を読み戻すことはありません。フローが変更した内容は次の方法で取得します： **すべてのクエリを更新** で **完了時** を使用してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.