• 项目

SharePoint 列表连接类型 (SSRS)

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

使用本主题中的信息可以生成数据源。有关分步说明，请参阅如何添加和验证数据连接或数据源（Report Builder 3.0 和 SSRS）。

本文内容

连接字符串

查询

参数

操作指南主题

相关章节

连接字符串

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

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

有关连接字符串示例的详细信息，请参阅Report Builder 3.0 中的数据连接、数据源和连接字符串。

凭据

执行以下操作时需要提供凭据：运行查询、本地预览报表以及从报表服务器预览报表。

报表发布后，您可能需要更改数据源的凭据，以使报表在报表服务器上运行时，用于检索数据的权限有效。

可与此数据扩展插件一起使用的凭据类型取决于用作数据源的 SharePoint 列表的 SharePoint 技术配置。

凭据类型包括：

  • 当前 Windows 用户（也称为集成安全性）。

    • 对于配置为在“可信帐户”模式下与报表服务器一起使用的 SharePoint 技术，不支持此选项。

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

    • 对于配置为不使用报表服务器的 SharePoint 技术，不支持此选项。

  • 使用存储的用户名和密码。此选项仅支持 Windows 集成安全性。

  • 提示用户输入凭据。此选项仅支持 Windows 集成安全性。

  • 不需要提供任何凭据。若要使用此选项，必须为报表服务器配置无人参与的执行帐户。有关详细信息，请参阅 msdn.microsoft.com 上 Reporting Services 文档中的“配置无人参与的执行帐户”。

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

查询

若要设计一个查询，请基于数据源创建新数据集，然后打开关联的查询设计器。有关详细信息，请参阅如何创建共享数据集或嵌入数据集 (Report Builder 3.0 和 SSRS)。

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

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

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

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

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

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

不支持从多个列表中选择字段。

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

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

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

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

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

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

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

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

有关详细信息，请参阅SharePoint 列表查询设计器 (Report Builder 3.0)。

查询文本

若要查看图形查询设计器生成的查询，请切换到基于文本的查询设计器。在此视图中，您可以看到由图形查询设计器创建的 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 列表的所有字段。

参数

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

用于“返回首页”链接的箭头图标返回页首

相关章节

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

用于“返回首页”链接的箭头图标返回页首