Sharepoint 问题集锦 - 外部列表(external list) - 读取当前用户上下文或用户名作为筛选参数

在创建外部列表过程中，往往需要添加筛选参数，而较多开发用户，会关心如何在外部列表中，只显示当前用户相关的行。本例子中，我们以任务数据表来做例子，看看如何实现这个需求。

1）数据表tbl_task：

tbl_task数据：

数据表中，userid即为我们在sharepoint访问外部列表时，对当前用户筛选的字段。它的格式为hostname\username。大家按你们自己的实际情况填写即可。

2）创建外部列表

• 打开sharepoint designer，登陆sharepoint site
• 选择外部内容类型（External content type）
• 点击工具栏，外部内容列表，选择刚才创建的tbl_task表，右击创建操作类型。

　　　

　　　　注意：以上需要注意的是，要创建外部列表前，如果只是读取数据库的内容，必须同时创建“读取项” 和 “读取列表”操作。

• 创建“读取项”操作

　　　在创建读取项操作过程中，我们可以添加筛选器，类型选择User Context （用户上下文）

　　　需要注意的是，userid必须得勾选映射到标识符选项，不然后续添加的筛选器不能正常保存。

　　   

• 添加筛选器

　　　选择新建筛选器，筛选器类型选择“用户上下文”

　　　

• 返回参数中，userid勾选映射到标识符

　　　

• 创建“读取列表”操作

　　　在创建读取列表操作过程中，我们发现筛选器选项缺少“用户上下文”（如下图），没关系，后面通过其他方法添加这个筛选器。在创建过程中，无需添加筛选器，只需勾选id 和 userid的映射标识符选项即可，然后保存。

　　　

　　　

　　　

• 导出BDC模型

　　　

• 导出BDC模型将会保存为后缀为**.bdcm的xml文件，此处名称填写文件名即可，设置选择默认。

　　　

　　

3） 编辑BDCM文件。

　　　打开上一个步骤导出的BDCM文件，格式大概如下：

　　　

• 查找Method name=“tbl_task读取项”下的，FilterDescriptors节点，

• <FilterDescriptors>
      <FilterDescriptor Type="UserContext" Name="筛选器">
          <Properties>
              <Property Name="UsedForDisambiguation" Type="System.Boolean">false</Property>
              <Property Name="IsDefault" Type="System.Boolean">false</Property>
              <Property Name="CaseSensitive" Type="System.Boolean">false</Property>
          </Properties>
      </FilterDescriptor>
  </FilterDescriptors>

  复制整段FilterDescriptors

• 查找Method name="tbl_task读取列表"节点，把上面拷贝的FilterDescriptors粘贴在Method节点下。注意FilterDescriptors与Properties，AccessControlList节点同为Method节点的子节点。所以粘贴的时候，应该和它们在同一层。粘贴后的代码如下：

　　　

• 复制Parameter节点

　　　复制完了FilterDescriptor节点后，就需要复制Parameter节点。同样查找Method Name="tbl_task读取项"的节点，找到如下的Parameter节点：

　　　注意，同时拷贝Parameter Name="@id"的节点和Parameter Name="@userid"节点（下图蓝色筛选部分）。

　　　

• 在Method name=“读取列表”节点的Parameters节点中插入刚才拷贝的两个Parameter节点。

　　　

• 修改RdbCommandText中的Select语句

　　　“读取项”的RdbCommandText的内容

• <Property Name="RdbCommandText" Type="System.String">SELECT [id] , [userid] , [task_name] , [assign_date] FROM [dbo].[tbl_task] WHERE [id] = @id AND [userid] = @userid</Property>

  参照上面的语句，把“读取列表”的RdbCommandText的内容修改为

• <Property Name="RdbCommandText" Type="System.String">SELECT [id] , [userid] , [task_name] , [assign_date] FROM [dbo].[tbl_task] WHERE [userid] = @userid</Property>

  注意：读取列表无需[id]参数，而读取项则必须保留[id]参数。因为读取列表的时候，我们是需要列出当前用户对应的记录，而在读取项的时候，就需要指定记录的id，不然，在后面的外部列表中，查看每项记录的属性的时候，会一直指向同一条记录。

• 修改Entity version版本

  <Entity Namespace="http://localhost" Version="1.0.0.0" EstimatedInstanceCount="10000" Name="Task" DefaultDisplayName="Task">

  修改为1.1.0.0

• <Entity Namespace="http://localhost" Version="1.1.0.0" EstimatedInstanceCount="10000" Name="Task" DefaultDisplayName="Task">

  保存退出。

4） 导入BDC模型

　　　完成了bdcm文件的修改后，接下来的步骤就是把该文件重新导回Sharepoint中。

• 打开SharePoint 2010 Central Administration -> Business Data Connectivity Service

　　　

• 点击Import，选择刚才保存的bdcm文件task.bdcm, 然后点击Import
• 如果顺利完成，就会显示BDC Model was successfully imported.

5） 创建外部列表

完成了外部内容类型的修改后，现在就可以根据外部内容类型，创建外部列表。具体步骤，不再赘述。如果不出意外，现在查看新建的外部列表的时候，就可以成功过滤不属于当前用户的记录。

参考：

• External Lists (BCS): Read List User Context filter http://www.thesharepointbar.com/?p=340

[The End]