> 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/open-flow-dialog.md).

# フロー ダイアログを開く

## 概要

Open Flow Dialog Interaction は、Salesforce Experience Cloud 環境内のモーダルダイアログで Salesforce フローを起動します。このインタラクションにより、ユーザーは現在のページから移動することなく、プロセスを完了したりデータを入力したりできます。

{% hint style="danger" %}

#### ダイアログボックスまたはパネルでフローを表示する

「Open Flow Dialog Interaction」機能を使って Salesforce Flow をポップアップのダイアログボックスで起動したい場合、エラーを避けるために適切な設定が不可欠です。これと同じ考え方は、ダイアログではなくサイドパネルに Flow を表示する「Flow Panel Interaction」にも当てはまります。以下では、設定手順、それが必要な理由、そして両方に共通する重要なヒントを説明します。

#### ダイアログまたはパネル表示用にフローを設定する手順

1. **Experience Cloud サイトにフローを追加する**\
   使用したいフローをサイト内の任意のページに配置します。公開ページや表示中のページである必要はありません。サイト構造のどこかに追加されていれば十分です。これにより、システムがそのフローにアクセスできるようになります。\
   ![](/files/99a18d10179845d582dc650021a8d4774ed48927)
2. **サイトを公開する**\
   フローを追加した後、サイトを公開します。この手順により、Experience Cloud にフローが登録され、ダイアログやパネルでトリガーされた際に正しく読み込めるようになります。

#### なぜこの設定が必要なのか？

棚にない本を開こうとしていると想像してください。利用できるようになるまで読むことはできません。同様に、Experience Cloud はフローを取得して表示するために、そのフローがサイトの枠組み内に存在している必要があります。これがないと、ダイアログやパネルはフローを見つけられず、読み込みの問題が発生します。

#### 重要な注意事項

* **表示は不要です:** フローをホストしているページは、ユーザーがアクセスできる必要も、表示される必要もありません。サイト構造の一部である限り、システムは裏側でそれを利用できます。
* **Flow Panel Interaction の場合:** これはダイアログと同じ仕組みで動作しますが、フローをスライド表示のサイドパネルで開くため、より控えめな体験になります。ユーザーにメインページを表示したまま、フローとやり取りしてほしい場合に使用します。
* **トラブルシューティングのヒント:** フローが表示されない場合は、公開済みであることを再確認し、プレビューまたは公開サイト環境でテストしてください。
  {% endhint %}

## チュートリアル

| 名前                                                                                                                                                                                   | 説明                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| [**ボタンをクリックしてフローを開くように Open Flow Dialog を設定する**](/experience-cloud/experience-cloud-ja/chtoriaru/interactions/configure-the-open-flow-dialog-to-open-a-flow-by-clicking-a-button.md) | Avonni Button のクリックで Salesforce フローを起動する方法を学び、Experience Cloud のユーザー体験を向上させましょう。 |

## プロパティ

| 名前                    | 説明                                                                                                                                                                                      |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`フロー API 名`**       | 起動する Salesforce フローの一意の識別子です。                                                                                                                                                           |
| **`入力変数`**            | 特定のデータコンテキストでフローを開始するために必要な変数です。                                                                                                                                                        |
| **`モーダルヘッダー`**        | フロー ダイアログの上部に表示されるタイトルです。                                                                                                                                                               |
| **`アクセシブルな説明`**       | ダイアログの内容を簡潔に説明する文で、スクリーンリーダーに文脈を提供し、アクセシビリティを向上させます。                                                                                                                                    |
| **`サイズ`**             | <p>モーダルの事前設定サイズ:</p><ul><li><code>小</code>: 入力項目が少ない、集中して取り組むタスクに最適です。</li><li><code>中</code>: デフォルトサイズで、ほとんどのフローに適しています。</li><li><code>大</code>: より多くの画面領域を必要とする複雑なフローに最適です。</li></ul> |
| **`閉じるボタン付きフッターを表示`** | トグルにより、ダイアログにモーダルを閉じるボタン付きのフッターを表示するかどうかを決定します。                                                                                                                                         |
| **`完了時のインタラクション`**    | フローが正常に完了した後の動作を定義します。                                                                                                                                                                  |
| **`閉じる時のインタラクション`**   | ユーザーが手動でフロー ダイアログを閉じたときの動作を定義します。                                                                                                                                                       |
| **`エラー時のインタラクション`**   | フロー内でエラーが発生した場合に実行するアクションを指定します。                                                                                                                                                        |

### 効果的に使うためのヒント

* フローが直感的に操作でき、すべての項目にわかりやすいラベルが付いていることを確認してください。
* さまざまなデバイスサイズと画面解像度で、フローの機能とユーザー体験をテストしてください。
* 完了時のインタラクションでフローの結果を明確にし、適切なユーザー期待値を設定してください。
* フローが Experience Cloud で正しく実行できるアクセス権を持っていることを確認してください。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
