如何：将比较筛选器添加到返回数据的方法实例中

  • 项目

上次修改时间： 2010年4月16日

适用范围： SharePoint Server 2010

比较筛选器将返回的实例限制为符合条件的那些实例。SQL 支持将比较筛选器与 WHERE 子句一起使用。您通常将为 SpecificFinder 方法或 Finder 方法实例定义比较筛选器。

在本主题中，将一个名为 StateFilter 的比较筛选器添加到 Contact 外部内容类型的 Finder 方法实例。

先决条件

  • Microsoft SQL Server 2005 或更高版本安装在运行 SharePoint Server 的服务器上。

  • AdventureWorks 2008 数据库安装在运行 SharePoint Server 的服务器上。

  • 已基于 AdventureWorks 数据库创建了 Contact 外部内容类型。有关详细信息，请参阅如何：创建外部内容类型。

使用 SharePoint Designer 向方法示例中添加筛选器

  1. 启动 Microsoft SharePoint Designer 2010，然后打开包含外部内容类型的 SharePoint 网站。

  2. 在 SharePoint Designer 2010 中，单击左侧导航窗格上的"外部内容类型"。这将显示在该网站的服务应用程序的 Business Data Connectivity (BDC) Service 元数据存储区中定义的所有外部内容类型。选择"Contact"外部内容类型。

  3. 单击"Contact Finder"操作以添加一个筛选器。这将显示"参数配置"向导。

  4. 单击"筛选器参数"。在筛选器参数向导中，单击"新建参数"。

  5. 将筛选器字段选为"State"。单击"筛选器参数"。

  6. 在"筛选器参数"对话框中，单击"新建筛选器"，然后将新筛选器的名称指定为 StateFilter。

  7. 然后，将筛选器的类型选为"比较"。将筛选器字段选为"State"。单击"确定"以关闭"筛选器参数"对话框。

  8. 将筛选器参数的默认值输入为 Washington。单击"确定"，然后单击"保存"以保存该外部内容类型。

请注意，现在最终用户将能够为 StateFilter 输入自己的自定义筛选值，以查看外部列表（举例来说）中经筛选的实例。

提示和警告

  • 如果在 Microsoft Outlook 或 Microsoft SharePoint Workspace 中使已经过筛选的外部列表脱机，则只在客户端上部署列表中当前可用的实例。例如，如果将您的列表限制为仅显示来自美国新泽西州的客户，然后单击"连接到 Outlook"，则将只在 Outlook 中部署那些来自美国新泽西州的客户。

最佳做法

  • 您应该为 SpecificFinder 方法和 Finder 方法定义用户筛选器，以限制从后端返回的实例。建议使用限制筛选器。

  • 针对输入参数，定义系统筛选器；而针对返回参数，定义用户筛选器。

  • 定义筛选器的默认值；否则，将不会从后端返回任何实例。

  • 针对返回多个实例的方法定义限制筛选器或页面筛选器。