1. 概述编辑
1.1 版本说明
报表服务器版本 | 插件版本 | 自定义加载项版本 | 系统要求 | office要求 | 功能变动 |
---|---|---|---|---|---|
11.0 | 1.0.12 | 1.0.0 | Windows 注:暂不支持MAC | office 2013 及以上 / WPS 2019 及以上 专业版/个人版 | 新增 Word 报告功能 |
11.0.5 及之后版本 | 2.0.1 | - | WPS 2021 及以上 专业版/个人版 | 1)WPS 版本新增「动态图表」。 2)新增「资源库」功能,仅支持引用挂载到数据决策系统中的报表资源。 3)修复 WPS 版本无法显示参数面板问题,使用填报预览即可。 4)修复 WPS 版本无法新建空白文件问题。 | |
11.0.6 及之后版本 | 2.0.2 | - | WPS 2021 及以上 专业版/个人版 | 1)新增支持「零客户端打印」功能 2)支持定时调度任务,勾选后附件存档仅支持word与pdf格式,处理方式仅支持邮件消息与短信消息,支持FTP与SFTP上传 3)支持繁体 4)动态图表支持多系列图表 | |
11.0.6 及之后版本 | 2.0.3 | - | WPS 2021 及以上 专业版/个人版 | 1)新增支持引用当前模板资源,无需挂载 2)新增 WPS 原生表格形式引用表格 3)新增「可重复动态文本」 |
1.2 应用场景
学习此文档前需要您先了解 Word 报告基本开发流程:Word 报告,本文主要讲解资源插入方式以及注意事项。
1.3 教学视频
2. 资源插入方式编辑
2.1 插入公式
Word 报告支持插入公式,公式的写法与 FineReport 相同,将光标放在要插入公式的地方,点击左上角「公式」按钮即可出现弹窗,在弹窗内输入公式即可。如下图所示:
2.2 插入单元格
可以用公式按钮,也可以直接手写,在{{=}} 的等于号后面写单元格即可,如下图所示:
2.3 插入数据列
Word 报告支持引用当前模板和平台挂载模板中的数据列,同时支持模板数据集和服务器数据集。
选择工具栏中的「数据列」按钮,可以在页面左侧的「资源中心」查看当前模板数据列以及平台挂载模板的数据列,光标放置在需要引用数据列的位置,再选择需要引用的数据列,双击即可引用对应的数据列,如下图所示:
2.4 插入报表区域
报表区域其实就是表格,把光标放在要插入的地方,点击左上角「表格」按钮,可以在页面左侧的「资源中心」查看当前模板表格以及平台挂载模板的表格,选择需要插入的表格,双击对应的 sheet 名称,在弹出的「选择表格区域」对话框内输入插入的表格位置,选择「尺寸」和「预览/导出时展示形式」,点击确定即可,如下图所示:
1)「尺寸」若设置为自定义大小则在word内生成占位图,可自行调节占位图的大小与位置。预览后的结果表格,与占位图的大小与位置保持一致。若设置为表格原尺寸则表格尺寸保持不变。
2)引用的表格资源中「预览/导出时展示形式」设置为表格,则支持导出后对表格二次编辑。若设置为图片导出后表格显示为图片,不支持导出后对表格二次编辑。
注:表格所处单元格需要填写大写的英文字母和整数。
2.5 插入图表
Word 报告支持引用当前模板和平台挂载模板中的数据列,把光标放在要插入的地方,点击左上角「图表」按钮,可以在页面左侧的「资源中心」查看服务器内的所有图表,选择需要插入的图表,双击对应的图表名称,即可插入图表,如下图所示:
2.6 参数查询
1)Word 报告支持在模板中自定义参数可以直接引用自定义参数,以此来避免进行二次复杂计算。参数可以直接用公式来定义,如下图所示:
2)支持引用在报表中定义参数,并在参数面板中添加控件,从而实现查询效果,如下图所示:
2.7 重复动态文本
在 Word 中添加重复动态文本控件,可以将固定内容的重复一定的次数,重复的次数支持使用公式进行计算,控件内容可以为固定文字,FineReport 公式,数据列,自定义参数等。
注:重复动态文本尽量避免放在段落中间。
点击左上角「可重复动态文本」按钮,在弹窗中输入需要重复的次数,点击确定,并在文本控件内输入需要重复的内容,如下图所示:
重复次数:count(UNIQUEARRAY(ds2.select(销售员))) ,意为计算 ds2 数据集中的销售员的人数
需要重复的内容:{{=Value("ds2","销售员")}}的销售总量为{{=2:C2!}},意为显示 ds2 数据集中销售员对应的销售总量,销售总量引用sheet3 中的 C2 单元格的值。
2.8 动态图表
注:动态图表仅支持引用平台挂载的模板中的数据
先将模板挂载数据决策平台后,在 Word 端点击「动态图表」,在弹出的对话框中选择「打开报表」,选择对应的报表,点击确定,选择图表所需要的数据并设置「分类」、「系列」、「值」,确定后会默认展示为柱形图,点击「更改图形」选择自己需要的图形即可,保存后重新打开报表进行预览即可看到制作好的图表,如下图所示:
2.9 插入组件
点击左上角「组件」按钮,可以在页面左侧的「资源中心」查看 FRM 模板中的套用组件,选择需要插入的组件,双击对应的名称,即可插入组件,如下图所示:
3. 注意事项编辑
3.1 公式书写要求
1)Word 里面插入公式时不需要格式嵌套
例如:插入一个单元格的写法是:{{=M3}}
此时如果想要对这个单元格求和,正确的写法是:{{=SUM(M3)}}
求和公式括号里面的单元格不要再加公式格式了,也就是不要错写成:{{=SUM({{=M3}})}}
2)Word 里面插入公式不支持引用层次坐标
3.2 资源存放位置
准备资源时,可以引用当前报表中的数据列、图表、表格等,以及支持引用挂载到数据决策系统中的模板内容。
3.3 重复动态文本控件说明
1)控件中的参数不参与重复,若想重复参数需要添加=,例如自定义参数为:{{=$a}},在控件中引用需要输入:{{==$a}}
2)重复文本最好单独成行,不要跟其他文字在一个段落中间使用,可能出现换行问题。
3)使用添加数据列的单元格默认采用最后一个数据,例如: 如设计器内 L1 单元格添加数据列 ds1.a,word 模板内直接引用 L1 单元格,默认逻辑为最后位,在L1后添加!即可展示全部数据 {{=L1!}} ,如下图所示:
3.4 隐藏资源
如果有资源预览时不希望报表和资源同时展示,那么需要隐藏掉这些资源。
首先明确一点,插件暂不支持直接隐藏行列这个办法,如下图所示,这个方法不要用。
可行的方法如下:条件属性设置行高或列宽为0
选中要隐藏的单元格列,添加行高或列宽为0的条件属性,如下图所示:
3.5 隐藏底部sheet栏
如果其他 sheet 有放资源,预览时底部会出现 sheet 栏,如下图所示:
预览时想隐藏底部的 sheet 栏,只需要给模板添加一个「加载结束」事件,如下图所示:
JavaScript 代码如下:
$(".fr-tabpane-controlbuttons.ui-state-enabled").hide()
$(".fr-tabpane-tabscontent-bg").hide();
3.6 IF多条件判断
在实际开发时,可能不止是 if else 两个判断这么简单,有的时候会有多个条件判断。
例如分析指标时一般会有 3 个判断:上升、下降、持平。
这样的多条件判断需要通过 if 嵌套的方式实现,公式逻辑是:if(condition,result1,(if(condition,result2,result3)))
举个例子:{{=if(N23<0,"下降"+format(N23*-1," #0.0%"),if(N23>0,"增长"+ format(N23," #0.0%"),"持平"))}}
3.7 预览即显示默认值查询的数据
如果 Word 报告模板有设置参数查询,预览时希望直接显示出控件默认值的查询结果,而不是一篇空白,等着用户去选参数然后点查询。
设置方法:取消勾选参数面板属性下的「点击查询前不显示报表内容」。
3.8 不支持同时打开多个报表
word 报告插件暂时不支持同时打开多个文档,打开多个 word 时其他已经打开的 cpt 再次上传就需要从新上传,此时上传为覆盖保存,覆盖保存会使模板的 sheet 和数据集丢失。