脱机和 Outlook 筛选器和模板
发布日期： 2017年1月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
Microsoft Office Outlook 的数据筛选器确定应在 Microsoft Dynamics 365 服务器和 Dynamics 365 for Outlook 之间同步哪些数据。Microsoft Dynamics 365 和 Microsoft Dynamics 365 (online) 支持使用 SDK 更新默认筛选器并将这些更改推送到任何所所有用户的功能。
作为对筛选器自定义的新支持的一部分，您可以编写允许管理员创建和发布筛选器模板的代码。 这允许 Microsoft Dynamics 365 管理员创建可发布给用户的常用或所需的筛选器，以便与 Microsoft Outlook 存储和脱机数据库同步。 这还提供了一种方法，可以自定义将对在最初发布模板后添加到系统的用户应用的默认筛选器模板。 管理员还能够在发布用户筛选器后更新或删除它们。
为支持这些自定义项，已保存查询（视图）有四种新查询类型。 在创建已保存查询（视图）记录时，使用 SavedQueryQueryType 枚举在 SavedQuery.QueryType 属性中指定这些类型之一。 只能通过使用此处介绍的方法访问这些类型；未提供任何 UI 来更改它们。 您可以指定不同的筛选器，以便可以避免将所有内容都同步到移动电话的 Microsoft Outlook 中。 筛选器模板可识别解决方案，因此它们可以随解决方案一起导出。
下表列出用于筛选器和筛选器模板的新查询类型。
查询类型 |
说明 |
|---|---|
定义要与 Dynamics 365 for Outlook 同步的实体子集。 这些筛选器定义的数据子集将同步到 Microsoft Outlook 文件夹，例如“联系人”、“日历”等。 |
|
定义要与 带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook 同步的实体子集。 这些筛选器定义的数据子集将同步到脱机数据库。 |
|
定义应用于新用户的筛选器模板，以便与 Dynamics 365 for Outlook 同步。 |
|
定义应用于新用户的筛选器模板，以便与 带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook 同步。 |
实例化筛选器
在创建同步订阅时，将自动为每个用户的 UserQuery 实体实例化默认筛选器模板。 在启动与 Microsoft Outlook 或脱机数据库的同步后，将收集该用户的筛选器并使用它们来筛选要同步的条目和属性的集合。 如果为特定实体指定了多个筛选器，则生成的条目集将是各个筛选器的结果的联合。
有一个新的特权允许管理员访问其他用户的筛选器：prvAdminFilter。 这在 Web 应用程序中称为“管理用户同步筛选器”。 系统管理员角色包括此特权，因为没有它，只有用户可以查看其筛选器。 对用户查询调用 IOrganizationService.RetrieveMultiple 方法将只检索负责人用户的记录，除非调用方具有 prvAdminFilter 特权。查询必须包含条件，其中 QueryType 等于 OutlookFilters 或 OfflineFilters 并且 OwnerId 等于 UserId，其中 UserId 不等于调用方。 如果为查询添加了任何其他条件，这将不会运行。
根据 SavedQuery.IsDefault 属性中标记为默认值的筛选器模板，自动为新用户提供筛选器。 管理员需要知道他们可以更改此值来影响筛选器。 每个实体只能有一个标记为默认值的筛选器模板。 不能有默认筛选器，只能有默认筛选器模板。 如果创建自定义实体并设置 IsAvailableOffline 属性，则会自动创建默认筛选器模板。
有一个管理员可以定义的新筛选器类型，称为系统筛选器。 这些筛选器定义为查询类型为 OutlookFilters 或 OfflineFilters 的 SavedQuery 记录。 系统筛选器自动应用于所有用户，并且无法由用户修改。
对于可添加的筛选器数量，存在限制。 此设置由 Microsoft Dynamics 365 部署管理员控制，用于阻止用户或管理员创建太多筛选器，从而不会影响服务器性能。 对所有实体应用同一限制设置。
默认情况下，系统筛选器和用户筛选器的设置不受限制。
实例化模板
可以为每个用户实例化一个或多个筛选器。 若要手动执行此操作，请使用 InstantiateFiltersRequest 实例化筛选器，从而创建用户查询记录。 每个用户查询记录包含对筛选器的引用。 如果您更新筛选器，则可以再次调用实例化以刷新或替代用户对筛选器所做的更改（用户查询记录）。
将用户的筛选器重置为默认值
可以使用 ResetUserFiltersRequest 将用户的筛选器重置为默认值。
另请参阅
InstantiateFiltersRequest
ResetUserFiltersRequest
扩展 Microsoft Dynamics 365 for Outlook
为 Microsoft Dynamics 365 for Outlook 编写自定义代码
SavedQuery（视图）实体消息和方法
示例：创建和检索 Outlook 筛选器
权限映射的安全角色 UI
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权