[]
        
在线Demo 免费试用
(Showing Draft Content)

集成报表

1. 概述

1.1 功能概述

通过IFrame容器技术,您可将Wyn的单张报表无缝集成至现有Web应用系统,快速实现嵌入式报表的实时查看与交互分析,让数据洞察深度融入业务流程。

2. 操作步骤

2.1 获取报表URL

  1. 在文档门户中,选择需要集成的报表,单击页面操作栏的在新窗口中浏览报表按钮image,即可在新的浏览器窗口中打开报表,然后将报表的URL地址拷贝粘贴到记事本中待用。

    PixPin_2025-07-21_16-47-28

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

    PixPin_2025-07-21_16-56-43

  3. 例如,在集成上图中的文档时,我们可以使用如下两个URL:

    报表文档ID: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

    type=info

    注意: 当采用文档名称进行集成时,若后续系统中该文档名称发生变更,原集成URL将因名称不匹配而失效,导致文档无法正常访问。

2.2 添加用户令牌

  1. 在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用 “&token=” 进行连接,得到最终的 URL 字串。

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

    type=info

    注意: 生成令牌时使用的用户,应具有查看报表的基本权限以及查看目标报表的权限

2.3 更多集成参数

  1. 集成参数列表:

    序号

    参数

    说明

    可选值

    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。

    image2022-3-25_11-48-29.png

    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

    用于在浏览器标签上添加额外的标题。

    输入的文本内容将显示在浏览器的页签上。

    image

    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时,该参数会被忽略。