# クエリ ## 概要 クエリデータソースは、次のような Avonni データコンポーネントが [**データテーブル**](/experience-cloud/experience-cloud-ja/chtoriaru/konpnento/dtatburu.md), [**リスト**](/experience-cloud/experience-cloud-ja/experience-components/ax-risuto.md), [**ギャラリー**](/experience-cloud/experience-cloud-ja/experience-components/ax-gyarar.md)、およびマップが Experience Cloud サイト上で Salesforce レコードデータを動的に取得して表示できるようにします。 このデータソースは、コンテンツを Salesforce のデータと同期させ、ページ上のユーザー操作に動的に反応させる必要がある状況を念頭に設計されています。 *** ## Avonni クエリデータソースとは？ Avonni クエリデータソースは Avonni コンポーネントを直接 **Salesforce オブジェクト** に接続し、SOQL に似た概念の構成可能なクエリを視覚的に作成します。 Experience Cloud の文脈では、次を可能にします： * Salesforce レコードからの動的なデータ取得 * [**リアクティブな振る舞い**](/experience-cloud/experience-cloud-ja/hajimeni/riakutibukonpnento.md) 同じページ上のコンポーネント間での *** ## クエリの作成 クエリは作成されます **Avonni コンポーネントから直接**. 新しいクエリを作成するには： 1. Experience Builder で Avonni データコンポーネント（例： **データテーブル** または **リスト**）を選択します 2. コンポーネントのプロパティパネルで、 **データソース** セクションを開きます 3. を選択します **クエリ** をデータソースとして 4. クエリのフィールド、フィルター、およびオプションを構成します *** ## データのフィルタリング ### クエリフィルターの構成 フィルターを使用すると、SOQL の `WHERE` 句に似た形で、クエリによって返される Salesforce レコードを制御できます。 フィルターはクエリエディタ内で直接構成され、そのクエリを使用するすべてのコンポーネントに適用されます。 *** ### フィルターの種類 **静的フィルター** 静的フィルターは構成時に定義された固定値を使用します。 例： * フィールド： `場所` * 演算子： `等しい` * 値： `ニューヨーク` 静的フィルターはクエリが編集されない限り変わりません。 *** ## リアクティブクエリ **リアクティブクエリとは？** リアクティブクエリは、Experience Cloud ページ上の Avonni コンポーネントがユーザーの操作や他のコンポーネントの変更に応じて自動的に更新されるようにします。 これにより、ページの再読み込みやカスタムコードなしで高度に動的でインタラクティブなページが実現します。 詳細を見る *** ## クエリデータソースを使用するタイミング 次の場合にクエリデータソースを使用してください： * データが Salesforce レコードと同期され続ける必要がある場合 * コンテンツがユーザーの操作に反応する必要がある場合 * 複数のコンポーネントが同じデータセットを共有する必要がある場合 * フィルタリングやグループ化のロジックが必要な場合 静的または編集ベースのコンテンツの場合は、代わりに次を検討してください： [**手動**](/experience-cloud/experience-cloud-ja/puropatipaneru/dtassu/shou-dong.md) または [**CMS コレクション**](/experience-cloud/experience-cloud-ja/puropatipaneru/dtassu/cms-korekushon.md) のデータソース。 --- # Agent Instructions: 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: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/dtassu/kueri.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.