如何:将比较筛选器添加到返回数据的方法实例中
上次修改时间: 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 向方法示例中添加筛选器
启动 Microsoft SharePoint Designer 2010,然后打开包含外部内容类型的 SharePoint 网站。
在 SharePoint Designer 2010 中,单击左侧导航窗格上的"外部内容类型"。这将显示在该网站的服务应用程序的 Business Data Connectivity (BDC) Service 元数据存储区中定义的所有外部内容类型。选择"Contact"外部内容类型。
单击"Contact Finder"操作以添加一个筛选器。这将显示"参数配置"向导。
单击"筛选器参数"。在筛选器参数向导中,单击"新建参数"。
将筛选器字段选为"State"。单击"筛选器参数"。
在"筛选器参数"对话框中,单击"新建筛选器",然后将新筛选器的名称指定为 StateFilter。
然后,将筛选器的类型选为"比较"。将筛选器字段选为"State"。单击"确定"以关闭"筛选器参数"对话框。
将筛选器参数的默认值输入为 Washington。单击"确定",然后单击"保存"以保存该外部内容类型。
请注意,现在最终用户将能够为 StateFilter 输入自己的自定义筛选值,以查看外部列表(举例来说)中经筛选的实例。
提示和警告
- 如果在 Microsoft Outlook 或 Microsoft SharePoint Workspace 中使已经过筛选的外部列表脱机,则只在客户端上部署列表中当前可用的实例。例如,如果将您的列表限制为仅显示来自美国新泽西州的客户,然后单击"连接到 Outlook",则将只在 Outlook 中部署那些来自美国新泽西州的客户。
最佳做法
您应该为 SpecificFinder 方法和 Finder 方法定义用户筛选器,以限制从后端返回的实例。建议使用限制筛选器。
针对输入参数,定义系统筛选器;而针对返回参数,定义用户筛选器。
定义筛选器的默认值;否则,将不会从后端返回任何实例。
针对返回多个实例的方法定义限制筛选器或页面筛选器。