集成报表

功能概述

可以把单张报表嵌入到 Web 应用程序的 IFrame 容器中，来快速实现嵌入式的报表查看和分析能力。

具体实施步骤如下：

1. 获取报表URL

选择需要集成的报表，单击页面右上角的新窗口按钮，在新的浏览器窗口中打开。

将报表的URL地址拷贝粘贴到记事本中待用。

与集成仪表板不同的是，报表集成还支持使用文档名称集成。也就是说，集成单张报表时，既可以使用原 URL 中的文档 ID，也可以将文档 ID 替换为文档的名称进行集成。这在集成多张报表时就带来了一定的便利性。

比如，在集成上图中的文档时，我们可以使用如下两个URL：

http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage&parampanel=top&theme=default&lng=zh

或

http://localhost:51980/reports/view/1-表格-财政教育经费投入情况表?display=singlepage&parampanel=top&theme=default&lng=zh

不过需要注意的是，使用文档名称进行集成时，一旦系统中的文档名称发生变化，那么使用原URL将无法打开文档。

2. 添加用户令牌

在获取到 URL 后，需要添加用户令牌来进行身份认证和权限认证，其格式为一系列包含字母和数字的字符串，例如：

A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

如何生成和获取令牌请参考生成令牌一节。

type=warning
注意
生成令牌时使用的用户，应具有查看报表的基本权限以及查看目标报表的权限。

在获取到令牌后，将其添加到目标 URL 的末尾，并使用 “&token=” 进行连接，得到的URL字串如下，

http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage&parampanel=top&theme=default&lng=zh&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

3. 更多集成参数

	参数	说明	可选值
1	display	用于单张报表集成，设置打开报表时页面默认的预览视图。	Singlepage（单页视图）、Pageless（不分页）、Continuous（多页视图）
2	toolbarSize	用于控制报表页面工具栏的高度。	s（代表31px）、m（代表41px，即默认大小）、l（51px）
3	dp	用于指定报表的参数。	参数值可以是“字符串”、“整数”、“浮点”、“日期时间”或“多维”类型。语法： &dp={"参数1名称":["参数1值1","参数1值2","参数1值3"],"参数2名称":["参数2值1","参数2值2","参数2值3"]}
4	reportItems	用于集成报表中指定的组件，多个组件可用逗号相隔。	如：&reportItems=表格1,图片1。
5	loadChart	控制在查看器中初始加载图表时的加载动画效果。	将其设置为“true”以启用加载动画效果，设置为“False”以禁用加载动画效果。
6	hoverChart	控制鼠标悬停时图表上的悬停效果。	将其设置为“true”以启用悬停效果，将其设置为“False”以禁用悬停效果。
7	hoverTable	控制鼠标悬停时表格和 tablix 行的悬停效果。	将其设置为“true”以启用悬停效果，将其设置为“False”以禁用悬停效果。
8	hoverTableBackgroundColor	指定鼠标悬停在表格和矩表行上时的背景颜色.	支持以下值: $theme（背景颜色取决于门户主题背景颜色） $origin（背景颜色保持不变） red（背景颜色基于指定的颜色值） %2330a0a0（背景颜色基于指定的十六进制值）
9	hoverTableTextColor	指定鼠标悬停在表格和矩表行上时的文本颜色。	支持以下值： $theme（文本颜色取决于门户主题文本颜色） $origin（文本颜色保持不变） red（文本颜色基于指定的颜色值） %2330a0a0（背景颜色基于指定的十六进制值）
10	horizontalAlignment	设置报表页面的水平对齐方式。	参数值为 left， center， right ，对应左/中/右。
11	parameterPanelPosition	设置报表参数面板的位置。	支持 right 和 top ，分别对应参数面板在右侧或上方。
12	parameterPanelRoundedControls	设置是否开启参数面板中元素的圆角效果。	参数值支持 true 和 false。
13	parameterPanelShowMode	设置是否显示参数面板。	支持的参数值为 always。
14	chartTooltip	设置是否开启报表中图表的鼠标提示标签。	参数值支持 true 和 false。
15	chartTooltipBackgroundColor	设置报表图表中鼠标提示标签的背景颜色。	支持的参数值有： $theme $none 有效的CSS颜色值，如blue。
16	chartTooltipBorderColor	设置报表图表中鼠标提示标签的边框颜色。	支持的参数值有： $theme $none 有效的CSS颜色值，如blue。
17	chartTooltipBorderRadius	设置报表图表中鼠标提示标签的边框的圆角弧度。	有效的数字，单位为 px或 pt 如： ? chartTooltipBorderRadius = 5px
18	chartTooltipBorderSize	设置报表图表中鼠标提示标签的边框的粗细。	有效的数字，单位为 px或 pt 如： ? chartTooltipBorderSize = 2px
19	chartTooltipBorderStyle	设置报表图表中鼠标提示标签的边框的线型。	None、 Dotted、 Dashed、 Solid、 Double、 Groove、 Ridge、 Inset、 Outset
20	chartTooltipFontFamily	设置报表图表中鼠标提示标签中文字的字体。	有效的字体类型。使用自定义字体时，用法如下： ?chartTooltipFontFamily=server-font-自定义字体的ID 例如： ?chartTooltipFontFamily=server-font-7b29b607-ecf9-4914-9811-bd5cdacc3983
21	chartTooltipFontSize	设置报表图表中鼠标提示标签的字体大小。	有效的数字，单位为 px或 pt
22	chartTooltipFontStyle	设置报表图表中鼠标提示标签的字体是否是斜体。	Normal、 Italic
23	chartTooltipFontWeight	设置报表图表中鼠标提示标签的字体是否粗体。	Lighter Thin ExtraLight Light Normal Medium SemiBold Bold ExtraBold Heavy Bolder
24	chartTooltipTextColor	设置报表图表中鼠标提示标签的字体颜色。	支持的参数值有： $theme $none 有效的CSS颜色值，如 ? chartTooltipTextColor = rgb(0,0,0)
25	title	用于在浏览器标签上添加额外的标题	输入的文本内容将显示在浏览器的页签上。

功能概述
1. 获取报表URL
2. 添加用户令牌
3. 更多集成参数