オフラインと Outlook のフィルターおよびテンプレート

[アーティクル]
03/22/2023

Office Outlook のデータフィルターは、Dynamics 365 for Customer Engagement サーバーと Dynamics 365 for Outlook で同期する必要があるデータを決定します。 Dynamics 365 for Customer Engagement は SDK を使用して既定のフィルターを変更し、一部またはすべてのユーザーに対してこの変更を配信する機能をサポートします。

フィルターカスタマイズの新しいサポートの一部として、管理者がフィルターテンプレートを作成して公開するためのコードを作成できるようになりました。これにより、Dynamics 365 for Customer Engagement 管理者は、Outlook ストアやオフラインデータベースと同期させるための共通のフィルターや目的のフィルターを作成し、ユーザーに公開できます。また、テンプレートを最初に公開した後でシステムに追加されたユーザー向けに、既定のフィルターテンプレートをカスタマイズして適用することもできます。管理者は、ユーザーフィルターを公開した後でそのフィルターを更新または削除することもできます。

これらのカスタマイズをサポートするため、保存済みクエリ (ビュー) 用の新しい 4 つのクエリの種類があります。保存済みクエリ (ビュー) レコードを作成する場合は、SavedQueryQueryType 列挙体を使用して、SavedQuery.QueryType 属性でこれらの種類のいずれかを指定します。これらには、ここで説明するメソッドを使用することによってのみアクセスできます。変更に使用できる UI はありません。携帯電話の Outlook に対してすべてのデータを同期させることを回避するには、別のフィルターを指定できます。フィルターテンプレートはソリューションに対応しているため、ソリューションと一緒にエクスポートできます。

次の表はフィルターとフィルターテンプレートで使用される新しいクエリの種類を示します。

クエリの種類	説明
OutlookFilters	Dynamics 365 for Outlook と同期させるエンティティのサブセットを定義します。これらのフィルターで定義されるデータのサブセットは、取引先担当者、カレンダーなど、 Outlook のフォルダーに同期します。
OfflineFilters	オフラインアクセスで Dynamics 365 for Microsoft Office Outlook と同期させるエンティティのサブセットを定義します。これらのフィルターで定義されるデータのサブセットは、オフラインデータベースに同期します。
OutlookTemplate	Dynamics 365 for Outlook と同期させるために新しいユーザーに適用するフィルターテンプレートを定義します。
OfflineTemplate	オフラインアクセスで Dynamics 365 for Microsoft Office Outlook と同期させるために新しいユーザーに適用するフィルターテンプレートを定義します。

フィルターのインスタンスの作成

同期サブスクリプションが作成されると、既定のフィルターテンプレートのインスタンスがユーザーごとに UserQuery エンティティに対して自動的に作成されます。 Outlook またはオフラインデータベースに対する同期が開始されると、対応するユーザーのフィルターが収集され、それらのフィルターを使用して同期対象のエントリと属性のコレクションがフィルター処理されます。特定のエントリに対し複数のフィルターが指定されている場合、エントリの結果セットは個々のフィルターの結果を合わせたものになります。

管理者が他のユーザーのフィルターにアクセスすることを許可する新しい権限 prvAdminFilter があります。これは、Web アプリケーションでは [ユーザー同期フィルターの管理] と呼ばれます。この権限がないと、ユーザーのフィルターを表示できるのは所有ユーザーのみなので、システム管理者のロールにはこの権限が含まれます。 IOrganizationService.RetrieveMultiple メソッドを呼び出したときに、呼び出し側が prvAdminFilter 特権を持っていない場合、取得されるのは所有ユーザーのレコードのみとなります。クエリには、UserId が呼び出し側と等しくない場合に、QueryType が OutlookFilters または OfflineFilters と等しく、かつ OwnerId が UserId に等しいという条件が含まれている必要があります。その他の条件がクエリに追加されると、これは機能しません。

新しいユーザーには、SavedQuery.IsDefault 属性で既定として指定されているフィルターテンプレートからフィルターが自動的に提供されます。管理者は、この値を変更するとこの処理に影響する可能性があることを認識する必要があります。各エンティティに適用できるのは、既定として指定されている 1 つのフィルターテンプレートのみです。既定のフィルターがなく、フィルターテンプレートのみの場合もあります。ユーザー定義エンティティを作成し、IsAvailableOffline プロパティを設定すると、既定のフィルターテンプレートが自動的に作成されます。

システムフィルターと呼ばれる、管理者が定義できる新しい種類のフィルターがあります。これらのフィルターは、クエリの種類が OutlookFilters または OfflineFilters である SavedQuery レコードとして定義されます。システムフィルターは、すべてのユーザーに自動的に適用されます。ユーザーはこのフィルターを変更できません。

追加できるフィルターの数には制限があります。この設定は、ユーザーや管理者がフィルターを作成しすぎてサーバーのパフォーマンスに影響しないように、Dynamics 365 for Customer Engagement の展開管理者によって制御されます。すべてのエンティティに対して同じ制限の設定が適用されます。

既定では、システムフィルターとユーザーフィルターの両方で無制限に設定されます。

テンプレートのインスタンスの作成

ユーザーごとに 1 つ以上のフィルターのインスタンスを作成できます。これを手動で行うには、InstantiateFiltersRequest を使用してフィルターのインスタンスを作成し、ユーザークエリレコードを作成します。各ユーザークエリレコードには、フィルターへの逆参照が含まれます。フィルターを更新する場合は、インスタンス作成を再び呼び出して更新するか、フィルター (ユーザークエリレコード) に対するユーザーの変更を無効にできます。

ユーザーのフィルターを既定にリセットする

ユーザーのフィルターを既定にリセットするには、ResetUserFiltersRequest を使用します。

オフラインと Outlook のフィルターおよびテンプレート

フィルターのインスタンスの作成

テンプレートのインスタンスの作成

ユーザーのフィルターを既定にリセットする

関連項目

その他のリソース