大网数据广告活动
数据库与应用安全

SharePoint 列表连接类型 (SSRS)

· 52CE 我爱测

若要在报表中包含来自 Microsoft SharePoint 列表的数据,您必须添加或创建一个基于 Microsoft SharePoint 列表类型的报表数据源的数据集。 此内置数据源类型是基于 Microsoft SQL Server Reporting Services SharePoint 列表数据扩展插件。 使用此数据源类型连接到 SharePoint 2013 及更高版本,并从中检索列表数据。

适用对象:yesSQL Server 2016yesPower BI 报表服务器 是SharePoint

若要在报表中包含来自 Microsoft SharePoint 列表的数据,您必须添加或创建一个基于 Microsoft SharePoint 列表类型的报表数据源的数据集。 此内置数据源类型是基于 Microsoft SQL Server Reporting Services SharePoint 列表数据扩展插件。 使用此数据源类型连接到 SharePoint 2013 及更高版本,并从中检索列表数据。

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

连接字符串

SharePoint 列表的连接字符串是指向 SharePoint 站点或子站点(例如, https://MySharePointWeb/MySharePointSite 或 https://MySharePointWeb/MySharePointSite/Subsite)的 URL。

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

有关更多连接字符串的示例,请参阅 报表生成器中的数据连接、数据源和连接字符串。

凭据

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

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

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

表 1

受支持的凭据 经典模式 Windows 身份验证 *声明身份验证
本地场 SharePoint 列表 Windows 身份验证(集成)或 SharePoint 用户标记 用户帐户控制 用户帐户控制
存储、提示、无(带有 Windows 凭据) 不支持带有非 Windows 凭据的存储和提示凭据。 用户帐户控制 否
远程 SharePoint 列表 Windows 身份验证(集成)或 SharePoint 用户标记 用户帐户控制 否 远程 SharePoint 列表不支持基于窗体的身份验证和声明身份验证。
存储、提示、无(带有 Windows 凭据) 不支持带有非 Windows 凭据的存储和提示凭据。 用户帐户控制 否 远程 SharePoint 列表不支持基于窗体的身份验证和声明身份验证。

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

表 2

受支持的凭据 经典模式 Windows 身份验证 *声明身份验证
本地场 SharePoint 列表 Windows 身份验证(集成)或 SharePoint 用户标记 用户帐户控制 用户帐户控制
存储、提示、无(带有 Windows 凭据) 不支持带有非 Windows 凭据的存储和提示凭据。 否 否
远程 SharePoint 列表 Windows 身份验证(集成)或 SharePoint 用户标记 用户帐户控制 否 远程 SharePoint 列表不支持基于窗体的身份验证和声明身份验证。
存储、提示、无(带有 Windows 凭据) 不支持带有非 Windows 凭据的存储和提示凭据。 否 否 远程 SharePoint 列表不支持基于窗体的身份验证和声明身份验证。

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

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

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

对于配置为不使用报表服务器的 SharePoint 技术(本地模式),不支持此选项。 有关本地模式的详细信息,请参阅报表查看器中的本地模式和连接模式报表对比(SharePoint 模式下的 Reporting Services)

不需要凭据(不使用凭据):
若要使用此选项,必须为报表服务器配置无人参与的执行帐户。 有关详细信息,请参阅配置无人参与的执行帐户(SSRS 配置管理器)。

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

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

查询

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

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

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

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

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

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

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

不支持从多个列表中选择字段。 可以为每个列表创建一个数据集并从每个数据集中选择字段。 如果这些列表具有通用字段,则可以使用绑定到一个数据集的 Tablix 数据区域中的 Lookup 函数从另一个未绑定到数据区域的数据集中检索值。 有关详细信息,请参阅 Lookup 函数(报表生成器和 SSRS)。

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

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

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

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

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

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

    您不能在图形查询设计器中更改排序顺序或指定组。 为了更改排序顺序或指定组,请对报表数据集设置排序表达式,并且对报表中数据区域上的表达式进行分组。 不支持查询参数。 若要筛选报表中的数据,请使用您创建的报表筛选器或报表参数。 有关详细信息,请参阅 对数据进行筛选、分组和排序(报表生成器和 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 列表的所有字段。

Parameters

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

操作指南主题

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

添加和验证数据连接(报表生成器和 SSRS)

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

向数据集添加筛选器(报表生成器和 SSRS)

相关章节

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

报表数据集 (SSRS)
提供访问报表数据的概述。

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

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

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

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

另请参阅

报表参数
对数据进行筛选、分组和排序
表达式(报表生成器和 SSRS)

更多疑问? 请访问 Reporting Services 论坛

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 markingmyname)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 05/10/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。