サーバー側のフィルタリングをキー列と参照列に限定する代わりに、すべての Web Services エンドポイント列に対してサーバー側でフィルタリングするかどうかを指定します。

データ型

bool

デフォルト値

false

解説

このプロパティは、URL に /ODataV4/ を含む Web Services エンドポイントにのみ影響します。 Common Service エンドポイントと Custom API エンドポイントは、すでにクエリ可能な任意の列に対してサーバー側でフィルタリングを行うため、このプロパティによってその動作が変わることはありません。 エンドポイントのカテゴリは、接続先の OrganizationURL から決まり、https://businesscentral.dynamics.com/ のようなフレンドリー URL の場合は EndpointType から決まります。 各エンドポイントカテゴリの説明およびそれを選択する URL 形式については、Business Central エンドポイント を参照してください。

Web Services エンドポイントは公開されたページを公開し、公開されたページはフィルタリングするよう設計されたフィールドに対してのみフィルタリングをサポートします。 それ以外のフィールドに対してフィルタリングを行うと、Microsoft Dynamics 365 Business Central から "Field 'X' is not filterable" エラーが返されます。 Microsoft Dynamics 365 Business Central は、公開されたページがどのフィールドに対するフィルタリングをサポートしているかを報告しないため、本製品 はこの2種類のフィールドを自身で区別することができません。

デフォルトである False に設定すると、本製品 は主キーと参照（外部キー）の条件のみを Web Services エンドポイントに送信します。 本製品 は一致する行を取得し、残りの WHERE 句をローカルで評価します。 クエリは常に成功しますが、選択性の高いクエリであっても、大きなテーブルに対して実行すると、一致しない行を破棄する前にそのテーブルの大部分を取得してしまう場合があります。

True に設定すると、本製品 はサポートされているすべての条件を Web Services 列について Microsoft Dynamics 365 Business Central に送信します。 大規模なトランザクションテーブルでは、これにより 本製品 が取得するデータ量とクエリの完了にかかる時間を大幅に削減できる場合があります。

注： このプロパティは、クエリ対象の公開されたページがフィルタリング対象のフィールドをサポートしていることが分かっている場合にのみ True に設定してください。 このプロパティを有効にすると、サポートされていないフィールドに対してフィルタリングを行うクエリは、ローカル評価によって成功する代わりに、Microsoft Dynamics 365 Business Central からのエラーで失敗します。 列挙型（オプションセット）に対応するフィールドは、Microsoft Dynamics 365 Business Central がフィールドに対して受け入れる選択肢の集合外の値を拒否するため、こうしたエラーの一般的な原因となります。

本製品 は、テーブルの列リストを構築する際にこのプロパティを適用します。 すでにメタデータを取得済みの接続で値を変更した場合は、以降のクエリを実行する前にキャッシュされたメタデータをクリアしてください。