[]
通过IFrame容器技术,您可将Wyn的单张报表无缝集成至现有Web应用系统,快速实现嵌入式报表的实时查看与交互分析,让数据洞察深度融入业务流程。
在文档门户中,选择需要集成的报表,单击页面操作栏的在新窗口中浏览报表按钮
,即可在新的浏览器窗口中打开报表,然后将报表的URL地址拷贝粘贴到记事本中待用。

相比仪表板集成,报表集成提供更灵活的文档标识方式:除标准文档ID外,您可直接使用易记的文档名称进行嵌入,这在批量集成多张报表时能显著提升配置效率和可维护性。

例如,在集成上图中的文档时,我们可以使用如下两个URL:
报表文档ID: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=zhtype=info
注意: 当采用文档名称进行集成时,若后续系统中该文档名称发生变更,原集成URL将因名称不匹配而失效,导致文档无法正常访问。
在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用 “&token=” 进行连接,得到最终的 URL 字串。
例如:http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage¶mpanel=top&theme=default&lng=zh&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6type=info
注意: 生成令牌时使用的用户,应具有查看报表的基本权限以及查看目标报表的权限。
集成参数列表:
序号 | 参数 | 说明 | 可选值 |
|---|---|---|---|
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 | 用于在浏览器标签上添加额外的标题。 | 输入的文本内容将显示在浏览器的页签上。
|
26 | showScrollbars | 用于设置报表的滚动条是否始终显示。 | 参数值支持true和false。 默认为false,即滚动条不始终显示。 |
27 | scrollbarsWidth | 用于设置滚动条的宽度。 | 默认值为8px。用户输入滚动条的宽度即可。 ?scrollbarsWidth= 15 |
28 | scrollbarsTrackColor | 用于设置滚动条轨道的颜色。 | 支持的参数值有: $theme $none 有效的CSS颜色值,如 ?scrollbarsTrackColor = rgb(0,0,0) |
29 | scrollbarsThumbColor | 用于设置滚动条滑块的颜色。 | 支持的参数值有: $theme $none 有效的CSS颜色值,如 ?scrollbarsTrackColor = rgb(0,0,0) |
30 | scrollbarsThumbHoverColor | 用于设置悬浮时滚动条滑块的颜色。 | 支持的参数值有: $theme $none 有效的CSS颜色值,如 ?scrollbarsTrackColor = rgb(0,0,0) |
31 | scrollbarsGrowOnHover | 用于设置滚动条滑块在鼠标悬浮时是否变大。 | 参数值支持true和false。 默认为false,即滚动条不始终显示。 当showScrollbars=true时,该参数会被忽略。 |
32 | scrollbarsThumbOpacity | 用于设置滚动条轨道的透明度 | 支持的参数值范围为0-100。 默认值为0,即为不透明。参数值越大,滚动条轨道的透明度越高,100为透明。 当showScrollbars=true时,该参数会被忽略。 |
33 | scrollbarsTrackOpacity | 用于设置滚动条滑块的透明度 | 支持的参数值范围为0-100。 默认值为0,即为不透明。参数值越大,滚动条滑块的透明度越高,100为透明。 当showScrollbars=true时,该参数会被忽略。 |