如何:向操作中添加筛选器参数以限制来自外部系统的实例

上次修改时间: 2009年9月24日

适用范围: SharePoint Server 2010

最终用户可能需要检索匹配某个条件的外部内容类型的实例(比如在外部列表中检索)。例如,用户可能希望只显示居住在"New Jersey"的用户或某个特定客户下的订单。若要启用此功能,外部内容类型的设计器可向所需操作添加筛选器。在上述状态筛选器示例中,设计器会创建一个筛选器参数 Comparison Type,然后使用此新建的筛选器来标记 Finder 方法中的 State 字段。多个此类筛选器可能与单个方法 (API) 关联。然后,用户选择运行时所需的筛选器并为其指定一个值,并且 BDC 将此筛选器的值传递给后端方法,这会将该值插入后端所需的准确位置,从而使其只返回用户希望看到的行。

筛选器是供 Business Data Connectivity (BDC) Service 用来捕获用户(或系统)输入并将其插入到后端 API 调用的基本方法。筛选器描述应将筛选值插入一系列复杂参数中的哪个位置。可通过"标记"输入或返回方法定义的参数以标记应执行插入的位置来完成此操作。请注意,后端必须提供筛选功能,这一点非常重要;筛选器只会构建一种用于将此功能呈现给最终用户的机制。

业务线 (LOB) 系统提供了各种筛选机制。BDC 将常见模式抽象化,使其为用户提供相同的筛选语义,而不管数据源如何。BDC 支持多个筛选器和筛选模式。有关详细信息,请参阅 Business Data Connectivity Service 支持的筛选器的类型

用户筛选器(如 Comparison)声明用户可重写的输入,而系统筛选器(如 UserContext 和 UserProfile)允许 BDC 安全设置值(如用户令牌)。

重要注释重要说明

如果元数据作者创建了错误的元数据(该数据将用户名用作用户可控制的筛选器并返回敏感的个人数据),则用户可能会看到其他用户的数据。若要避免出现此情况,请使用 UserContextFilter 将用户名传入方法调用。

客户端会查询元数据存储库,以确定系统支持的筛选器并相应呈现其用户界面。

请参阅

任务

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