> 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).

# Flow ダイアログを開く

モーダルダイアログでSalesforceフローを起動し、ユーザーが現在のページから移動せずにプロセスを完了したりデータを入力したりできるようにします。

## 概要

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

## 設定

{% hint style="danger" %}

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

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

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

1. **Experience Cloud サイトにフローを追加する**\
   サイト内の任意のページに使用したいフローを配置します。公開ページや表示されるページである必要はありません。サイト構造のどこかに追加されていれば十分です。これにより、システムがフローにアクセスできるようになります。\
   ![](https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-81a1cb7bdb1c4b002c0cc75c48226dfa66ff6d23%2F2024-10-30_16-42-48.png?alt=media)
2. **サイトを公開する**\
   フローを追加した後、サイトを公開します。この手順により Experience Cloud にフローが登録され、ダイアログやパネルでトリガーされたときに正しく読み込まれるようになります。

#### この設定が必要な理由は？

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

#### 重要な注意事項

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

| 名前                         | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`API名`**                 | 起動するSalesforceフローの一意の識別子。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **`入力変数`**                 | <p>フローの開始前に渡されるオプション変数で、フローが必要とする初期値やコンテキストを提供します。各変数は次を定義します:</p><ul><li><strong>名前</strong>: 設定するフロー入力変数のAPI名。</li><li><strong>値</strong>: 割り当てる値 — 静的テキストまたは動的式。</li><li><strong>タイプ</strong>: 値のデータ型（<code>文字列</code>, <code>数値</code>, <code>ブール値</code>, <code>日付</code>, <code>日時</code> または <code>SObject</code>).</li><li><strong>オブジェクト型</strong>: 型が <code>SObject</code>の場合、オブジェクトのAPI名（例： <code>Account</code> または <code>Contact</code>）を指定すると、フローがオブジェクト構造を正しく解釈できます。</li><li><strong>コレクションかどうか</strong>: フロー変数が単一値ではなく値のコレクションを想定している場合に有効にします。</li></ul> |
| **`モーダルヘッダー`**             | フローダイアログの上部に表示されるタイトル。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **`モーダルのアクセシブルな説明`**       | ダイアログの内容を簡潔に説明するもので、スクリーンリーダーに文脈を提供し、アクセシビリティを向上させます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **`モーダルサイズ`**              | <p>モーダルの事前設定サイズ：</p><ul><li><code>小</code>: 既定値。入力項目が少ない、集中した作業に最適です。</li><li><code>中</code>: ほとんどのフローに適しています。</li><li><code>大</code>: より広い画面領域を必要とする複雑なフローに最適です。</li><li><code>全画面</code>: 最も複雑な体験向けのフルスクリーンダイアログです。</li></ul>                                                                                                                                                                                                                                                                                                                                           |
| **`閉じるボタン付きのモーダルフッターを表示`** | トグルにより、ダイアログにモーダルを閉じるボタン付きフッターを表示するかどうかを決定します。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **`閉じるボタンのラベル`**           | フッターの閉じるボタンのラベルです。「閉じるボタン付きのモーダルフッターを表示」が有効な場合に使用できます。文言を調整するために使用します（例：閉じる、キャンセル、完了）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **`完了時`**                  | フローが正常に完了した後の動作を定義します。使用可能なインタラクションは `トーストを表示` および `すべてのクエリを更新`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **`閉じる時`**                 | ユーザーがフローダイアログを手動で閉じたときの動作を定義します。使用可能なインタラクションは `トーストを表示` および `すべてのクエリを更新`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **`エラー時`**                 | フロー内でエラーが発生した場合に実行するアクションを指定します。使用可能なインタラクションは `トーストを表示` および `すべてのクエリを更新`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

## 例

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

## 重要な考慮事項

* フローが直感的で、すべての項目に明確なラベルが付いていることを確認してください。
* さまざまなデバイスサイズと画面解像度でフローの機能性とユーザー体験をテストしてください。
* フローの結果を **完了時** インタラクションで明確にして、適切なユーザーの期待値を設定してください。
* フローが 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 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/open-flow-dialog.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.
