SharePoint 列表连接类型 (SSRS)

若要在报表中包含来自 Microsoft SharePoint 列表的数据，您必须添加或创建一个基于 Microsoft SharePoint 列表类型的报表数据源的数据集。 此内置数据源类型是基于 Microsoft SQL Server Reporting Services SharePoint 列表数据扩展插件。 使用此数据源类型可连接到 SharePoint 2013、SharePoint Foundation 2010、SharePoint Server 2010、Windows SharePoint Services 3.0 和 Office SharePoint Server 2007 站点，并从中检索列表数据。

使用本主题中的信息来生成一个数据源。 有关分步说明，请参阅添加和验证数据连接或数据源（报表生成器和 SSRS）。

本文内容

连接字符串

查询

参数

操作指南主题

相关章节

连接字符串

SharePoint 列表的连接字符串是指向 SharePoint 站点或子站点（例如，http://MySharePointWeb/MySharePointSite 或 http://MySharePointWeb/MySharePointSite/Subsite）的 URL。

查询设计器会自动显示您拥有足够访问权限的 SharePoint 列表。

有关连接字符串示例的详细信息，请参阅报表生成器中的数据连接、数据源和连接字符串。

凭据

执行以下操作时需要提供凭据：运行查询、本地预览报表以及从报表服务器预览报表。 报表发布后，您可能需要更改数据源的凭据，以使报表在报表服务器上运行时，用于检索数据的权限有效。 可与此数据扩展插件一起使用的凭据类型取决于用作数据源的 SharePoint 列表的 SharePoint 技术配置。

下表概括了在连接到本地场 SharePoint 列表和远程 SharePoint 列表时，SharePoint 列表扩展的凭据检索行为。

表 1 适用于部署到旧的 Windows SharePoint 站点的报表。 旧的 Windows 站点仅支持 Kerberos、NTLM 和基于窗体的身份验证 (FBA)。 表 2 适用于部署到基于声明的 SharePoint 站点的报表。

表 1

	受支持的凭据	经典模式 Windows 身份验证	3 声明身份验证
本地场 SharePoint 列表	Windows 身份验证（集成）或 SharePoint 用户标记	是	是
	存储、提示、无（带有 Windows 凭据1）	是	否
远程 SharePoint 列表	Windows 身份验证（集成）或 SharePoint 用户标记	是	否2
	存储、提示、无（带有 Windows 凭据1）	是	否2

表 2

	受支持的凭据	经典模式 Windows 身份验证	3 声明身份验证
本地场 SharePoint 列表	Windows 身份验证（集成）或 SharePoint 用户标记	是	是
	存储、提示、无（带有 Windows 凭据1）	否	否
远程 SharePoint 列表	Windows 身份验证（集成）或 SharePoint 用户标记	是	否2
	存储、提示、无（带有 Windows 凭据1）	否	否2

1 不支持带有非 Windows 凭据的存储和提示凭据。

2 远程 SharePoint 列表不支持基于窗体的身份验证和声明身份验证。

3 Windows 身份验证、基于窗体的身份验证 (FBA)、安全应用程序标记语言 (SAML) 标记、其他标识提供程序或以上提到的多个身份验证提供程序的组合。

-
Windows 身份验证
对于配置为在“可信帐户”模式下与报表服务器一起使用的 SharePoint 技术，不支持此选项。 这仅适用于 Reporting Services 的早期版本。

对于配置为在“Windows 集成”模式下与报表服务器一起使用的 SharePoint 技术，此选项既适用于当前 Windows 用户，也适用于当前 SharePoint 用户。

对于配置为不使用报表服务器的 SharePoint 技术（本地模式），不支持此选项。 有关本地模式的详细信息，请参阅[报表查看器中的本地模式和连接模式报表（SharePoint 模式下的 Reporting Services）](ff487969\(v=sql.110\).md)。

• 不需要凭据（不使用凭据）：
  若要使用此选项，必须为报表服务器配置无人参与的执行帐户。 有关详细信息，请参阅配置无人参与的执行帐户。

有关 Microsoft BI 堆栈中声明身份验证支持的信息，请参阅在 Microsoft BI 堆栈中使用声明身份验证。

有关详细信息，请参阅数据连接、数据源和连接字符串 (SSRS)、在报表生成器中指定凭据 和 Reporting Services 支持的数据源 (SSRS)。

查询

若要设计一个查询，请基于数据源创建新数据集，然后打开关联的查询设计器。 有关详细信息，请参阅创建共享数据集或嵌入数据集（报表生成器和 SSRS）。

SharePoint 列表图形查询设计器中显示四个窗格：

SharePoint 列表：显示该数据源在站点上的所有 SharePoint 列表的列表。 选择某一列表，然后选择要位于查询中的字段。 此窗格中字段的名称是 SharePoint 友好名称，也称为显示名称。 将鼠标指针悬停在某一项上可在工具提示中显示以下属性：

• 名称：字段的唯一名称。

• 标识符：字段的唯一标识符。

• 字段类型：字段的数据类型。

• 隐藏：字段是否显示在 SharePoint 列表视图中。

不支持从多个列表中选择字段。 你可以为每个列表创建一个数据集并从每个数据集中选择字段。 如果列表具有一个常见字段，你可以使用 Lookup 函数在绑定到一个数据集的 tablix 数据区域中检索来自其他数据集的值（未绑定到该数据区域）。 有关详细信息，请参阅Lookup 函数（报表生成器和 SSRS）。

• 所选字段：显示所选的字段。 此窗格中的字段名称是 SharePoint 用户指定的友好名称。 在您关闭查询设计器后，将会在“报表数据”窗格的数据集字段集合中看到这些名称。 在“数据集属性”对话框 ->“字段”（报表生成器） 页中提供了唯一名称和友好名称之间的关系。

• 应用的筛选器：在数据返回到报表中之前，限制从 SharePoint 列表返回的数据。 选择用于限制在列表中检索的数据的字段名称、运算符和值。 根据所选值的数据类型的不同，运算符也会有所不同。

  您不能在图形查询设计器中更改排序顺序或指定组。 为了更改排序顺序或指定组，请对报表数据集设置排序表达式，并且对报表中数据区域上的表达式进行分组。 不支持查询参数。 若要筛选报表中的数据，请使用您创建的报表筛选器或报表参数。 有关详细信息，请参阅 对数据进行筛选、分组和排序（报表生成器和 SSRS）和报表参数（报表生成器和 SSRS）。

• 查询结果：显示查询运行时返回的示例行。 如果 SharePoint 列表值在 SharePoint 站点上频繁更改，则您在查询结果窗格中看到的值可能不同于在报表中看到的值。

• 所选字段：显示所选的字段。 此窗格中的字段名称是 SharePoint 用户指定的友好名称。 在您关闭查询设计器后，将会在“报表数据”窗格的数据集字段集合中看到这些名称。 在“数据集属性”对话框 ->“字段”（报表生成器） 页中提供了唯一名称和友好名称之间的关系。

• 应用的筛选器：在数据返回到报表中之前，限制从 SharePoint 列表返回的数据。 选择用于限制在列表中检索的数据的字段名称、运算符和值。 根据所选值的数据类型的不同，运算符也会有所不同。

  您不能在图形查询设计器中更改排序顺序或指定组。 为了更改排序顺序或指定组，请对报表数据集设置排序表达式，并且对报表中数据区域上的表达式进行分组。 不支持查询参数。 若要筛选报表中的数据，请使用您创建的报表筛选器或报表参数。 有关详细信息，请参阅 对数据进行筛选、分组和排序（报表生成器和 SSRS）和报表参数（报表生成器和 SSRS）。

• 查询结果：显示查询运行时返回的示例行。 如果 SharePoint 列表值在 SharePoint 站点上频繁更改，则您在查询结果窗格中看到的值可能不同于在报表中看到的值。

有关详细信息，请参阅SharePoint 列表查询设计器（报表生成器）。

查询文本

若要查看图形查询设计器生成的查询，请切换到基于文本的查询设计器。 在此视图中，您可以看到由图形查询设计器创建的 XML。 该 XML 包括用于列表名称、字段集合和筛选器的元素。

示例 1：列表的指定字段

下面的示例演示一个格式正确的 SharePoint 查询：

<RSSharePointList>
<listName>MyList</listName>
<viewFields>
  <FieldRef Name="Field1"/>
  <FieldRef Name="Field4"/>
</viewFields>
<Query>
  <Where>
    <And>
      <Gt>
        <FieldRef Name="Field1"/>
        <Value Type="Integer">1</Value>
      </Gt>
      <IsNotNull>
        <FieldRef Name="Field2"/>
        <Value Type="string"/>
      </IsNotNull> 
    </And>
  </Where>
</Query>
</RSSharePointList>

您可以编辑此查询的视图，只要它保持格式正确的 XML 文本。

示例 2：列表的所有字段

您还可以仅指定列表的名称，包括隐藏字段在内的所有字段都将返回。 下面的示例从名为 Tasks 的列表中检索所有字段：

<RSSharePointList>
<listName>Tasks</listName>
</RSSharePointList>

在查询结果中返回 Tasks 列表的所有字段。

参数

此数据扩展插件不支持参数。

返回页首

故障排除

将 SharePoint 列表数据扩展插件用于 SSRS 2008 R2 或 SSRS 2012 中的报表时返回不同的数据 (https://support.microsoft.com/kb/2826162)

操作指南主题

本节包含使用数据连接、数据源和数据集的分步说明。

添加和验证数据连接或数据源（报表生成器和 SSRS）

创建共享数据集或嵌入数据集（报表生成器和 SSRS）

向数据集添加筛选器（报表生成器和 SSRS）

返回页首

相关内容

文档中的这些章节提供有关报表数据的深入概念性信息，以及有关如何定义、自定义和使用与数据相关的报表部件的步骤信息。

• 向报表添加数据（报表生成器和 SSRS）
  提供访问报表数据的概述。

• 报表生成器中的数据连接、数据源和连接字符串
  提供有关数据连接和数据源的信息。

• 报表的嵌入数据集和共享数据集（报表生成器和 SSRS）
  提供有关嵌入数据集和共享数据集的信息。

• 数据集字段集合（报表生成器和 SSRS）
  提供有关查询生成的数据集字段集合的信息。

• SQL Server联机丛书中的 Reporting Services 文档的 Reporting Services 支持的数据源 (SSRS)部分。
  提供有关每个数据扩展插件的平台和版本支持的详细信息。

返回页首

请参阅

概念

报表参数（报表生成器和 SSRS）

对数据进行筛选、分组和排序（报表生成器和 SSRS）

表达式（报表生成器和 SSRS）