> 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/data-sources/query.md).
# クエリ
## 概要
Query Data Source は、Avonni Data コンポーネント（たとえば [**データテーブル**](/experience-cloud/experience-cloud-ja/chtoriaru/components/data-table.md), [**リスト**](/experience-cloud/experience-cloud-ja/experience-components/ax-list.md), [**ギャラリー**](/experience-cloud/experience-cloud-ja/experience-components/ax-gallery.md)、および Map などを用いて、Experience Cloud サイト上で Salesforce レコードデータを動的に取得して表示できます。
このデータソースは、コンテンツを Salesforce データと同期させたままにし、ページ上のユーザー操作に動的に応答する必要がある場合に適しています。
***
## Avonni Query Data Source とは何ですか？
Avonni Query Data Source は、Avonni コンポーネントを直接次に接続します **Salesforce オブジェクト** 設定可能なクエリを介して。概念的には SOQL に似ていますが、視覚的に作成できます。
Experience Cloud の文脈では、次のことが可能になります：
* Salesforce レコードからの動的なデータ取得
* [**リアクティブな動作**](/experience-cloud/experience-cloud-ja/hajimeni/reactive-components.md) 同じページ上のコンポーネント間で
***
## クエリの作成
クエリは作成されます **Avonni コンポーネントから直接**.
新しいクエリを作成するには：
1. Avonni Data コンポーネントを選択します（たとえば、 **データテーブル** または **リスト**）を Experience Builder で
2. コンポーネントのプロパティパネルで、次を開きます： **データソース** セクション
3. 選択 **クエリ** データソースとして
4. クエリのフィールド、フィルター、オプションを設定します
***
## データのフィルタリング
### クエリフィルターの設定
フィルターを使用すると、クエリによって返される Salesforce レコードを制御できます。これは次と同様です： `WHERE` SOQL の句。
フィルターはクエリエディターで直接設定され、そのクエリを使用するすべてのコンポーネントに適用されます。
***
### フィルターの種類
**静的フィルター**
静的フィルターは、設定時に定義された固定値を使用します。
例：
* 項目： `所在地`
* 演算子： `等しい`
* 値： `ニューヨーク`
静的フィルターは、クエリを編集しない限り変更されません。
***
## リアクティブクエリ
**リアクティブクエリとは何ですか？**
リアクティブクエリにより、Experience Cloud ページ上の Avonni コンポーネントは、ユーザー操作や他のコンポーネントの変更に応じて自動的に更新されます。
これにより、ページの再読み込みやカスタムコードなしで、非常に動的でインタラクティブなページを実現できます。
詳細を見る
***
## Query Data Source を使用するタイミング
次の場合に Query Data Source を使用します：
* データを Salesforce レコードと同期した状態に保つ必要がある場合
* コンテンツがユーザー操作に応答する必要がある場合
* 複数のコンポーネントで同じデータセットを共有する必要がある場合
* フィルタリングとグルーピングのロジックが必要な場合
静的コンテンツや編集用コンテンツには、次の使用を検討してください： [**手動**](/experience-cloud/experience-cloud-ja/puropatipaneru/data-sources/manual.md) または [**CMS コレクション**](/experience-cloud/experience-cloud-ja/puropatipaneru/data-sources/cms-collection.md) 代わりにデータソースを使用してください。
---
# 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/data-sources/query.md?ask=&goal=
```
`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.