Excel Add-In for Certinia

Build 25.0.9434

FilterScope

Salesforce のUSING SCOPE キーワードを使用してクエリで返されるレコードを制限するオプションのスコープを指定します。

Possible Values

None, Delegated, Everything, Mine, MineAndMyGroups, My_Territory, My_Team_Territory, Team

データ型

string

デフォルト値

"None"

解説

SOQL クエリを実行する際、このプロパティは"USING SCOPE" キーワードを追加し、選択されたフィルタスコープに基づいてクエリ結果を制限します。 これにより、Salesforce でのユーザーのロールと可視性設定に最も関連するレコードにクエリを絞り込むことができます。

例えば、FilterScopeMine に設定されている場合、クエリは現在認証されているユーザーが所有するレコードのみを取得します: SELECT Id, Name FROM Account USING SCOPE Mine

FilterScopeMineAndMyGroups に設定されている場合、クエリ結果はユーザーとその所属グループの両方が所有するレコードを含むように拡張されます。

FilterScope を使用することで、返されるレコード数を減らすことによりクエリパフォーマンスを向上させることができます。特に大規模なデータセットにおいて効果的です。 ただし、過度に制限的な設定は、クエリ結果から必要なレコードを除外してしまう可能性があるため、適切なスコープを選択するようにしてください。

このプロパティは、マルチユーザー環境において、ユーザーが自身のロール、チーム、または割り当てられたテリトリーに関連するレコードを取得するのに役立ちます。

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9434