コンテンツへスキップ
For the complete documentation index, see llms.txt. This page is also available as Markdown.

クエリ

概要

クエリ データソースにより、Avonni データコンポーネント(たとえば データテーブル, リスト, ギャラリー、およびマップ)が Experience Cloud サイト上で Salesforce レコードデータを動的に取得して表示できます。

このデータソースは、コンテンツを Salesforce データと同期させたまま保ち、ページ上のユーザー操作に動的に応答する必要がある場合向けに設計されています。


Avonni クエリ データソースとは何ですか?

Avonni クエリ データソースは、Avonni コンポーネントを直接次に接続します: Salesforce オブジェクト 設定可能なクエリを介して。SOQL の概念に似ていますが、視覚的に作成できます。

Experience Cloud の文脈では、次を可能にします:


クエリの作成

クエリは作成されます Avonni コンポーネントから直接.

新しいクエリを作成するには:

  1. Avonni データコンポーネントを選択します(たとえば、 データテーブル または リスト)を Experience Builder で

  2. コンポーネントのプロパティパネルで、 データソース セクションを開きます

  3. 選択します クエリ をデータソースとして

  4. クエリのフィールド、フィルター、オプションを設定します


権限

クエリは、ページを表示しているユーザーの権限で実行されます。そのユーザーのオブジェクトアクセス、項目レベルセキュリティ、共有ルールによって返されるレコードと項目が決まり、ブラウザーのリクエストがユーザーの持つ権限以上のアクセスを要求することはできません。

公開サイトでは、ログインしていない訪問者はゲストユーザーであるため、それらのクエリはゲストユーザープロファイルのアクセス権で実行されます。訪問者に対してはリストが空のままで、ログイン済みユーザーには表示される場合は、ゲストユーザープロファイルが何を読み取れるかを確認してください。

ページを作成するときには、次の 2 つのことが起こります:

  • 同じクエリでも、2 人のユーザーに異なる結果が表示されることがあります。営業マネージャーはデータテーブルですべての商談を見られる一方、パートナーユーザーは共有されたものだけを見ることができます。

  • クエリは、インストール済みパッケージの保護された設定を含むカスタム設定を読み取ることはできません。コンポーネントで設定データを表示する必要がある場合は、カスタムオブジェクトを使用してください。


データのフィルタリング

クエリ フィルターの設定

フィルターを使用すると、クエリによって返される Salesforce レコードを制御できます。これは、 WHERE 句に似ています。

フィルターはクエリエディターで直接設定され、そのクエリを使用するすべてのコンポーネントに適用されます。


フィルターの種類

静的フィルター

静的フィルターは、設定時に定義された固定値を使用します。

例:

  • 項目: 所在地

  • 演算子: 等しい

  • 値: ニューヨーク

静的フィルターは、クエリを編集しない限り変更されません。


リアクティブ クエリ

リアクティブ クエリとは何ですか?

リアクティブ クエリにより、Experience Cloud ページ上の Avonni コンポーネントは、ユーザーの操作や他のコンポーネントの変更に応じて自動的に更新できます。

これにより、ページの再読み込みやカスタムコードなしで、非常に動的でインタラクティブなページを実現できます。

詳細を見る


クエリ データソースを使用するタイミング

次の場合にクエリ データソースを使用します:

  • データを Salesforce レコードと同期したままにする必要がある

  • コンテンツがユーザー操作に反応する必要がある

  • 複数のコンポーネントで同じデータセットを共有する必要がある

  • フィルタリングとグループ化のロジックが必要である

静的コンテンツや編集コンテンツには、次の使用を検討してください: 手動 または CMS コレクション データソース

最終更新

役に立ちましたか?