将报表、模型和共享数据源部署到 SharePoint 站点
新建日期: 2006 年 12 月 12 日
若要将报表、报表模型、共享数据源和资源部署到 SharePoint 库,可以使用 Reporting Services 创作工具(报表设计器、报表生成器和模型设计器)发布内容,或者使用 SharePoint 站点操作来上载内容。
SharePoint 站点使用的 Web 地址与本机模式下的 Reporting Services 报表服务器的地址不同。 SharePoint 站点 Web 层次结构包括 SharePoint Web 应用程序、一个顶级站点和多个可选子站点以及库。 您必须知道如何创建 URL 地址,该地址指定 SharePoint 服务器以及 SharePoint 站点层次结构中的位置(您要在该位置发布报表或相关项)。 使用报表设计器、报表生成器或模型设计器将报表和相关文件发布到库时,会在添加文件前对文件进行验证。 如果通过使用 SharePoint 库的**“上载”**操作来上载报表和相关文件,则不进行验证检查。 直到通过管理、编辑和运行报表来访问时,您才会知道文件是否有效。
此外,报表定义中对共享数据源、子报表和资源(如基于 Web 的图像)的引用必须全部是 SharePoint 库的完全限定 URL。
站点层次结构
将报表服务器配置为在 SharePoint 集成模式下运行时,SharePoint Web 层次结构将用于对在报表服务器上处理和管理的项进行寻址。
以下 Web 层次结构元素可用于访问和保护报表服务器内容。 其他对象(如列表和页)不用于访问报表服务器内容,因此未在下表中进行说明。
对象 | 说明 |
---|---|
SharePoint Web 应用程序 |
SharePoint Web 应用程序可以作为独立的服务器安装,也可以在包含许多虚拟服务器的场中安装。 Web 应用程序具有 URL(例如,http://servername)并且可以包含多个站点。 |
站点 |
站点为 Web 应用程序的父站点或子站点。 |
SharePoint 库 |
库包含文档或文件夹。 库或库中的文件夹是仅有的可用来存储报表、报表模型、共享数据源和外部图像的站点对象。 |
项 |
可以在 URL 中引用的报表服务器项包括报表或子报表的报表定义、报表模型、共享数据源或外部图像。 |
URL 语法和规则
库中每个报表服务器项都由完全限定的 URL 进行标识,该 URL 包括协议前缀、服务器名、站点、库、文件名和文件类型的文件扩展名。
SharePoint 服务器的 URL
从 Business Intelligence Development Studio 向报表服务器部署报表服务器或报表模型项目时,必须使用 SharePoint 服务器的 URL。
若要找到要使用的服务器的名称,请打开一个浏览器并找到要发布报表的 SharePoint 库。 服务器名称紧接在协议前缀之后,例如 http://servername。
不支持使用 Reporting Services URL 代理端点。 代理端点包含一个端口号,例如 http://servername:8080/reportserver。
SharePoint 服务器站点或子站点的 URL
部署报表或报表数据源时,必须使用 SharePoint 站点和子站点的 URL(如果有)。 在该 URL 中,站点名紧接在服务器名之后,例如 http://servername/site 或 http://servername/site/subsite。
在 Microsoft Office SharePoint Server 2007 Web 应用程序中,站点和子站点经常对应于主站点上的选项卡。 若要找到站点名或子站点名,请单击**“主文件夹”,然后单击“所有网站内容”。 滚动到底部并查找“站点和工作区”**。 站点列表将显示在此部分中。
SharePoint 库的 URL
向 SharePoint 库中部署报表或相关项时,必须使用 SharePoint 库的 URL。 要用于库的 URL 根据所使用的 SharePoint 版本而不同。
在 Microsoft Windows SharePoint Services 3.0 中,库显示在服务器名之后,例如 http://*servername/*Shared Documents。
在 Office SharePoint Server 2007 中,库显示在站点和子站点之后。 例如,http://*servername/site/*Documents。
若要查找新的 SharePoint 库或某个不熟悉站点的路径信息,请打开浏览器,然后找到要发布报表的 SharePoint 库。 如果该库为空,则上载任意文件。 右键单击该文件,然后选择**“属性”以打开“属性”**窗口。 文件地址中包含发布操作所需的 URL 值。
SharePoint 站点上的项的完全限定 URL
始终通过完全限定的 URL 对存储在 SharePoint 库中的项进行寻址,这种完全限定的 URL 以 Web 应用程序开头 (http://server) 作为根节点,并以所引用的文件名结束。
URL 中的文件名必须包括文件扩展名。
不能对发布到 SharePoint 站点的报表中的依赖项使用相对 URL。 例如,不能使用相对 URL 来引用共享数据源、报表模型或子报表。 必须始终为每个项指定 SharePoint 库的完全限定 URL。 无法预测依赖文件可能处于的位置,这是因为没有可以用来分析 URL 格式的站点预定义层次结构。
发布或上载包含依赖项的报表时,必须在发布报表后设置对依赖项的引用。 不能保证在报表设计器的预览模式下可以正常使用的引用在发布报表后还能够正常使用。 有关详细信息,请参阅本主题中的从创作工具发布到 SharePoint 库。
外部图像的 URL
报表定义可以包括存储为外部文件的图像文件。 可通过设置图像文件的完全限定 URL 来引用报表定义中的该文件。 该文件可以存储在 SharePoint 站点上,也可以存储在远程计算机上。
无论采用何种报表服务器模式,在报表中对外部图像文件的引用必须为完全限定的 URL。 此外,引用外部图像文件通常会需要配置无人参与的报表处理帐户。
SharePoint 站点上的保留名称
如果要创建或构造位于 SharePoint 站点上的项的 URL,请注意:Personal 和 Sites 都是默认站点下的保留名称。
URL 示例
将项发布到 SharePoint 库中时,必须指定目标库的完全限定 URL。 完全限定的 SharePoint URL 包括 SharePoint Web 应用程序、站点、库、文件夹(可选)、文件和文件扩展名。 以下示例对应使用的语法进行了一些说明:
目标 | 示例 URL |
---|---|
SharePoint 服务器。 |
http://TestServer |
SharePoint 服务器站点或子站点。 |
http://TestServer/toplevelsite/subsite |
Windows SharePoint Services 部署的 Shared Documents 中的 Company Sales 示例报表。 |
http://TestServer/TestSite/Shared Documents/CompanySales.rdl |
Office SharePoint Server 实例的 Documents 中的 Company Sales 示例报表。 |
http://TestServer/TestSite/Documents/Doc/CompanySales.rdl |
Office SharePoint Server 实例的“报表中心”中的 Company Sales 示例报表。 |
http://TestServer/TestSite/Reports/Doc/CompanySales.rdl |
从创作工具发布到 SharePoint 库
如果将报表设计器、模型设计器或报表生成器升级到 SQL Server 2005 Service Pack 2 (SP2),则可以将这些项从创作工具发布到 SharePoint 库。 SP2 增加了对项目属性页中 SharePoint URL 的支持。 早期版本的创作工具不支持 SharePoint URL 作为有效位置。
使用报表设计器、报表生成器或模型设计器将报表和相关文件发布到库时,会在添加文件前对文件进行验证。 如果通过使用 SharePoint 库的**“上载”**操作来上载报表和相关文件,则不进行验证检查。 直到通过管理、编辑和运行报表来访问时,您才会知道文件是否有效。
共享数据源
从报表创作工具发布共享数据源时,要设置项目属性 TargetDataSourceFolder。 目标数据源文件夹必须是指向 SharePoint 库的 URL。 与在 Reporting Services 本机模式下不同,不能指定相对文件夹;相对路径是无效的。 如果文档库路径中不存在文件夹,则将创建一个文件夹。
将共享数据源 (.rds) 文件发布到 SharePoint 站点时,这会将数据源文件的扩展名更改为 .rsds。 无法将 .rsds 文件从 SharePoint 站点保存到本地,也无法将其导入到现有的 Reporting Services 项目。 文件扩展名为 .rds 和 .rsds 的共享数据源不可互换。
来自报表设计器的共享数据源
如果从报表设计器项目发布共享数据源,可以使用指定目标库的 URL,也可以将该属性保留为空。 与在 Reporting Services 本机模式下不同,不能指定相对文件夹;相对路径是无效的。 如果文档库路径中不存在文件夹,则将创建一个文件夹。 如果将目标数据源文件夹保留为空,则将在目标报表文件夹中发布数据源。
来自模型设计器的共享数据源
如果要从模型设计器项目发布共享数据源(.rds 文件或 .smdl 文件),则必须使用指定目标库的 URL。 不能指定相对文件夹;相对路径是无效的。 如果文档库路径中不存在文件夹,则将创建一个文件夹。 模型 (.smdl) 和共享数据源 (.rsds) 都将发布到此文件夹中,例如 http://servername/site/Documents/Data Sources。
文件名
URL 中的报表项文件名必须包含文件扩展名。 文件扩展名决定文件类型。 从报表创作工具发布报表项时,会自动包含文件扩展名。 如果将报表项上载到 SharePoint 库,则必须包含文件扩展名。
如果不为发布到 SharePoint 站点的项指定文件扩展名,则会发生 rsInvalidDataSourceReference 错误。 文件名不可以包括 SharePoint 应用程序无法识别为有效文件名字符的字符。 切勿包含以下字符:# % & * : < > ? / { | }.
如果报表定义包含对子报表的引用,则必须指定子报表的完全限定 URL。 不能指定相对文件夹;相对路径是无效的。
设置对依赖项的引用
对于已使用报表生成器创建的报表,报表定义包括对用于生成报表的报表模型和模型数据源的引用。 这些引用是在报表定义文件中指定的。 如果将此报表添加到报表设计器中的报表服务器项目来进行更改,然后将其发布到 SharePoint 库,则必须在 SharePoint 库中打开此报表,并重新绑定数据源引用。 仅在首次发布报表时,才需要重新绑定数据源。 报表服务器无法从报表定义中确定数据源是 .rsds 文件还是 .smdl 文件。 有关详细信息,请参阅如何将报表或模型绑定到共享数据源。
将 SP2 之前的项发布到 SharePoint 站点
若要发布在 SP2 版本之前的创作工具中创建的报表定义、报表模型和共享数据源,则必须在工具的 SP2 版本中打开或创建项目,然后发布文件。
另一种方法是将文件从文件系统直接上载到 SharePoint 库,然后运行报表以验证它是否起作用。 运行报表前必须先设置对所有依赖项的引用。
上载与发布之间的差异
使用报表设计器、报表生成器或模型设计器将报表和相关文件发布到库时,会在添加文件前对文件进行验证。 如果通过使用 SharePoint 库的**“上载”**操作来上载报表和相关文件,则不进行验证检查。 直到通过管理、编辑和运行报表来访问时,您才会知道文件是否有效。
更新已发布的项
将项发布或上载到 SharePoint 库后,应先从库中签出此项,然后再进行更新。 为您签出报表时,您将是唯一有权更改报表的用户。 结束操作后,将报表重新签入。
如果上载或发布报表时不先签出文档(例如上载与现有项同名的项),则报表服务器将会为您签出此文档,将更新后的报表添加为现有项的新版本,然后将此文档重新签入。
作为资源的外部图像
在本机模式下运行的报表服务器崇尚“资源”理念。资源指报表服务器存储和保护,但不处理的任何文件。 在本机模式下,资源可以是任何类型的文件。
报表服务器在 SharePoint 集成模式下运行时,资源理念的定义就会更窄。 报表服务器使用资源理念来存储引用外部图像的报表。 这适用于报表作为内部使用的快照或副本的情况。
请参阅
任务
如何将报表从报表设计器发布到 SharePoint 库(SharePoint 集成模式)
如何将共享数据源从报表设计器发布到 SharePoint 库(SharePoint 集成模式)