在分页报表中创建文档结构图或目录（报表生成器）

适用于： Microsoft Report Builder (SSRS) Power BI Report Builder SQL Server Data Tools 中的 Report Designer

创建文档结构图，在分页报表中提供一组可单击的链接或目录。 当你查看包含文档结构图的分页报表时，报表旁边会显示一个单独的侧窗格。 通过单击文档结构图中的链接，可跳至显示报表项的报表页。 报表的各区域和组将按一定层次结构的链接形式排列。 单击文档结构图中的项会刷新报表，并显示与文档结构图中所单击项对应的报表区域。

若要向文档结构图添加链接，则需要将报表项的 DocumentMapLabel 属性设置为您所创建的文本，或者设置为计算结果为您要在文档结构图中显示的文本的表达式。 还可以向文档结构图添加表或矩阵组的唯一值。 例如，对于基于颜色的组，每个唯一颜色都是指向显示该颜色组实例的报表页的一个链接。

您还可以创建指向报表的 URL 来覆盖文档结构图，这样在运行报表时可以不显示文档结构图，然后通过单击报表查看器工具栏中的 “显示/隐藏文档结构图” 按钮，可切换到显示文档结构图。

注意

在 SQL Server Data Tools 中，你可以在 Microsoft 报表生成器、Power BI 报表生成器和报表设计器中创建和修改分页报表定义 (.rdl) 文件。

当你在 Power BI 服务中查看分页报表时，不会呈现文档结构图。 但是当你导出报表时，它们会呈现。

文档结构图和呈现扩展插件

文档结构图专门用于 HTML 呈现扩展插件（如预览和报表查看器）。 其他呈现扩展插件具有不同的呈现文档结构图的方式：

• PDF 将文档结构图呈现为“书签”窗格。 有关详细信息，请参阅 导出到 PDF 文件（报表生成器）。

• Excel 将文档结构图呈现为包含链接层次结构的命名工作表。 各报表区域在不同的工作表中呈现，这些工作表与文档结构图处于同一工作簿中。 有关详细信息，请参阅 导出到 Microsoft Excel（报表生成器）。

• Word 中包含作为目录的文档结构图。 有关详细信息，请参阅 导出到 Microsoft Word（报表生成器）。

• Atom、TIFF、XML 和 CSV 将忽略文档结构图。

有关详细信息，请参阅不同报表呈现扩展插件的交互功能（报表生成器和 SSRS）。

向文档结构图添加报表项

1. 在“设计”视图中，选择要添加到文档结构图中的报表项，如表、矩阵或仪表。 报表项属性将显示在“属性”窗格中。

   注意

   若要选择 Tablix 数据区域，请在任意单元内单击以显示行控点和列控点，然后单击角控点。

2. 在“属性”窗格中，在 DocumentMapLabel 属性中键入要在文档结构图中显示的文本，或输入计算结果为标签的表达式。 例如，键入 Sales Chart。

   注意

   如果看不到“属性”窗格，请在 “视图” 选项卡的 “显示/隐藏” 组中选择 “属性” 。

3. 对要在文档结构图中显示的每个报表项重复步骤 1 和 2。

4. 单击 “运行” 。 将运行报表，并且文档结构图会显示您创建的标签。 单击任一链接，可跳至显示该报表项的报表页。

向文档结构图添加唯一组值

1. 在“设计”视图中，选择包含要在文档结构图中显示的组的表、矩阵或列表。 “分组”窗格随即显示行组和列组。

2. 在“行组”窗格中，右键单击相应的组，然后单击 “编辑组” 。 将打开 “Tablix 组属性” 对话框的 “常规” 页。

3. 单击“高级”。

4. 在 “文档结构图” 列表框中，键入或选择与组表达式匹配的表达式。

5. 选择“确定”。

6. 对要在文档结构图中显示的每个组重复步骤 1-4。

7. 单击 “运行” 。 将运行报表，并且文档结构图会显示组值。 单击任一链接，可跳至显示该报表项的报表页。

当你查看报表时隐藏文档结构图

1. 在 Web 门户中，浏览到包含文档结构图的报表。

   例如，对于 AdventureWorks2022 示例报表，以下 URL 指定名为 Product Catalog 的报表。

   https://localhost/Reports/Pages/Report.aspx?ItemPath=%2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog  
   

2. 复制服务器中的报表路径。 在该示例中，报表路径为 %2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog。

3. 使用以下三个组件创建一个新 URL：

   • 报表服务器中的报表查看器： https://localhost/ReportServer/Pages/ReportViewer.aspx?

   • 步骤 1 中复制的报表的名称，例如： %2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog

   • 指定隐藏文档结构图的设备信息参数： &rs%3aCommand=Render&rc%3aFormat=HTML4.0&rc%3aDocMap=False

   下面的 URL 由此三个组件以其所列顺序追加而成。

   https://localhost/ReportServer/Pages/ReportViewer.aspx?  
   %2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog  
   &rs%3aCommand=Render&rc%3aFormat=HTML4.0&rc%3aDocMap=False  
   

   若要使用此 URL，请复制此 URL，并删除所有换行符。

4. 将此 URL 粘贴到 Web 门户中，然后按 Enter。 将运行报表，并隐藏文档结构图。

注意

有关详细信息，请参阅 URL 访问。

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