集成报表
功能概述
可以把单张报表嵌入到 Web 应用程序的 IFrame 容器中，来快速实现嵌入式的报表查看和分析能力。
具体实施步骤如下：
1. 获取报表URL
选择需要集成的报表，单击页面右上角的新窗口按钮，在新的浏览器窗口中打开。
将报表的URL地址拷贝粘贴到记事本中待用。
与集成仪表板不同的是，报表集成还支持使用文档名称集成。也就是说，集成单张报表时，既可以使用原 URL 中的文档 ID，也可以将文档 ID 替换为文档的名称进行集成。这在集成多张报表时就带来了一定的便利性。
比如，在集成上图中的文档时，我们可以使用如下两个URL：
http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage¶mpanel=top&theme=default&lng=zh或
http://localhost:51980/reports/view/1-表格-财政教育经费投入情况表?display=singlepage¶mpanel=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¶mpanel=top&theme=default&lng=zh&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B63. 更多集成参数
参数 | 说明 | 可选值 | |
|---|---|---|---|
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 | loadChart | 控制在查看器中初始加载图表时的加载动画效果。 | 将其设置为“true”以启用加载动画效果， 设置为“False”以禁用加载动画效果。 |
5 | hoverChart | 控制鼠标悬停时图表上的悬停效果。 | 将其设置为“true”以启用悬停效果， 将其设置为“False”以禁用悬停效果。 |
6 | hoverTable | 控制鼠标悬停时表格和 tablix 行的悬停效果。 | 将其设置为“true”以启用悬停效果， 将其设置为“False”以禁用悬停效果。 |
7 | hoverTableBackgroundColor | 指定鼠标悬停在表格和矩表行上时的背景颜色. | 支持以下值: $theme（背景颜色取决于门户主题背景颜色） $origin（背景颜色保持不变） red（背景颜色基于指定的颜色值） %2330a0a0（背景颜色基于指定的十六进制值） |
8 | hoverTableTextColor | 指定鼠标悬停在表格和矩表行上时的文本颜色。 | 支持以下值： $theme（文本颜色取决于门户主题文本颜色） $origin（文本颜色保持不变） red（文本颜色基于指定的 颜色值） %2330a0a0（背景颜色基于指定的十六进制值） |
9 | horizontalAlignment | 设置报表页面的水平对齐方式。 | 参数值为 left， center， right ，对应左/中/右。 |
10 | parameterPanelPosition | 设置报表参数面板的位置。 | 支持 right 和 top ，分别对应参数面板在右侧或上方。 |
11 | parameterPanelRoundedControls | 设置是否开启参数面板中元素的圆角效果。 | 参数值支持 true 和 false。
|
12 | parameterPanelShowMode | 设置是否显示参数面板。 | 支持的参数值为 always。 |
13 | chartTooltip | 设置是否开启报表中图表的鼠标提示标签。 | 参数值支持 true 和 false。 |
14 | chartTooltipBackgroundColor | 设置报表图表中鼠标提示标签的背景颜色。 | 支持的参数值有： $theme $none 有效的CSS颜色值，如blue。 |
15 | chartTooltipBorderColor | 设置报表图表中鼠标提示标签的边框颜色。 | 支持的参数值有： $theme $none 有效的CSS颜色值，如blue。 |
16 | chartTooltipBorderRadius | 设置报表图表中鼠标提示标签的边框的圆角弧度。 | 有效的数字，单位为 px或 pt 如： ? chartTooltipBorderRadius = 5px |
17 | chartTooltipBorderSize | 设置报表图表中鼠标提示标签的边框的粗细。 | 有效的数字，单位为 px或 pt 如： ? chartTooltipBorderSize = 2px |
18 | chartTooltipBorderStyle | 设置报表图表中鼠标提示标签的边框的线型。 | None、 Dotted、 Dashed、 Solid、 Double、 Groove、 Ridge、 Inset、 Outset |
19 | chartTooltipFontFamily | 设置报表图表中鼠标提示标签中文字的字体。 | 有效的字体类型。 使用自定义字体时，用法如下： ?chartTooltipFontFamily=server-font-自定义字体的ID 例如： ?chartTooltipFontFamily=server-font-7b29b607-ecf9-4914-9811-bd5cdacc3983 |
20 | chartTooltipFontSize | 设置报表图表中鼠标提示标签的字体大小。 | 有效的数字，单位为 px或 pt |
21 | chartTooltipFontStyle | 设置报表图表中鼠标提示标签的字体是否是斜体。 | Normal、 Italic |
22 | chartTooltipFontWeight | 设置报表图表中鼠标提示标签的字体是否粗体。 | Lighter Thin ExtraLight Light Normal Medium SemiBold Bold ExtraBold Heavy Bolder |
23 | chartTooltipTextColor | 设置报表图表中鼠标提示标签的字体颜色。 | 支持的参数值有： $theme $none 有效的CSS颜色值，如 ? chartTooltipTextColor = rgb(0,0,0) |
