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.10 及之后版本 | 2.0.2 | - | WPS 2021 及以上 专业版/个人版 | 1)新增支持「零客户端打印」功能 2)支持定时调度任务,勾选后附件存档仅支持word与pdf格式,处理方式仅支持邮件消息与短信消息,支持FTP与SFTP上传 3)支持繁体 4)动态图表支持多系列图表 |
注1:该功能只支持普通报表,也就是 .cpt 报表。
注2:本文是对 Word 报告插件的基本介绍,只涉及基本开发流程,如果想要深入了解更多开发要点,请您学完本文后移步:Word报告开发须知和经验
1.2 应用场景
场景一:
将数据分析的结果转成 Word 报告是比较常见的业务需求,但是如果直接将报表导出为 Word 有时候并不合适。
因为正式的报告其实对内容和排版都是有较高要求的,比如想要在报告里面加描述性的语句来对指标进行分析,或者对字体和段落格式有固定要求。
如果直接将报表导出为 Word ,这个 Word 文件只有报表自身的内容,且 Word 格式和排版都是默认的,无法控制。
场景二:
报告中涉及到大量的数据指标,如果每次都要手动去改这些数字,麻烦不说还容易出错。
例如下图的空气质量监测报告,其中圈出是数据指标,每个月都会改变。怎么可以让这样的报告每个月自动生成呢?
FineReport方案:
FineReport 新推出的 Word 报告插件采用「WPS+设计器」的设计模式。
设计器里的数据集字段、参数、公式、图表、表格等称之为资源,这些资源的准备或设计都是在设计器里面完成。
WPS 里面可以直接插入这些资源,然后对这些资源的格式和排版进行调整,进而实现导出固定格式的 Word 文件。
在预览 Word 报告模板时,可以直观看到报告的最终效果,且支持原样导出该 Word 报告。预览效果如下图所示:
2. 环境准备编辑
2.1 获取安装包
1)扫码添加工作人员获取插件安装包,或您可以联系技术支持获取安装包
2)若您已安装插件,在使用期间遇到任何需求或问题,也可以扫码添加工作人员进行沟通或联系技术支持获得帮助。
技术支持联系方式如下:
在线QQ:800049425
热线电话:400-811-8890转2
2.2 安装插件
得到插件安装包后直接本地安装即可。
设计器插件安装方法参照:设计器插件管理
服务器安装插件方法参照:服务器插件管理
安装完成后登录数据决策系统,选择「管理系统>Word插件管理」,点击「FineReport」,弹窗「安装成功」即可完成安装,如下图所示:
3. 报告制作流程编辑
3.1 配置服务器地址
新建一个空白 Word 文档,点击功能区域的「FineReport」,再点击「服务器配置」设置项,弹出的「FineReport地址」对话框填写报表服务器地址。
下图连接的是设计器内置服务器,地址为:http://localhost:8075/webroot/decision,如果是远程设计环境,需要填入远程设计服务器地址,并登录数据决策平台选择「管理系统>word 插件管理」点击「FineReport」即可。最后点击「保存」即可。
这样 Word 就已经连接到了报表服务器,后面可以跟设计器一起联动设计报告。
3.2 登录服务器
上面配置服务器地址点击「下一步」,会自动弹出登录界面,也可以使用左上角的「登录」设置项进入登录界面。
如果是远程设计,则账号的登录权限跟 远程设计权限 保持一致,无远程设计权限的用户无法登录,且提示:无远程设计权限,若要进行远程设计,请管理员开启权限后登录。
登录的用户名和密码跟决策平台配置的用户名和密码相同,且登录时「保持登录状态」暂不可用,也就是每次重新打开 Word 后,要重新登录。
登录后左上角「登录」变为「注销」,点击可注销账号。
3.3 新建普通报表
1)在设计器端准备数据集、参数、图表这样的资源,在 Word 端设计报告的内容和排版,这些都是保存到一张普通报表里面去的。创建普通报表时要从 Word 端创建,方法如下:
点击「FineReport」加载项下的「保存」,在报表工程下新建一个普通报表。选择报表路径并给模板命名后,点击「确定」,弹出「上传成功」对话框,表示模板创建成功。
2)这时回到设计器,点击报表管理面板的刷新按钮,就可以看到新建的普通报表了。双击进入模板,可以看到 A1~K60 已经合并为一片区域。这个区域是 Word 占用的,预览模板时,可以在这个区域展示 Word 的实时内容。
Word 设计的内容是保存到模板里面的,如果想要查看或修改已有模板的 Word 内容,可以直接从 Word 端打开这个模板,对原来的设计进行修改。
3)登录数据决策系统,将新建的模板挂载到数据决策平台中即可,详情可参考:决策系统挂载报表。
3.4 准备资源
在 test.cpt 中新建两个数据集:
ds1 的 SQL 语句为:SELECT * FROM 销量
ds2 的 SQL 语句为:SELECT SUM(销量) AS 销售总量 FROM 销量
并在 L1~N2 区域设计一个表格,将数据集中字段拖到对应单元格中,如下图所示:
普通报表中准备好资源后,一定要点击「保存」报表,这样在 Word 中点击资源列表的「刷新」按钮,就可以让这些资源显示在资源列表处,如下图所示:
注:也就是说只要在报表中改动了一些资源,想要在 Word 中刷新生效,就一定要先保存这张报表。
3.5 插入资源
此处只展示往 Word 中插入数据集字段、公式、报表区域,其他类型的资源后面会介绍。
1)首先是插入公式实现动态标题,让 Word 标题里的日期一直是今天,在正文处输入文本:{{=FORMAT(today(),"yyyy年MM月dd日")}}销售报告,文本中包含公式和普通文字。
插入公式的方法:把光标放在要插入公式的地方,点击左上角「公式」按钮,光标处会出现{{=}},在等号后面输入公式即可。操作如下图所示:
注:暂未支持所有 FineReport 公式,存在个别公式插入后不生效的情况。
2)插入数据集字段的方法:工具栏中选择数据列将数据集展开,双击或拖拽字段,即可将字段添加到 Word 光标处,操作如下图所示:
3)可以将报表中一片表格区域插入到 Word 中。插入方法:把光标放在要插入的地方,点击工具栏上「表格」按钮,选择对应的图表,弹出「选择表格区域」对话框,输入表格左右范围即可。操作如下图所示:
3.6 预览文档
建议使用 Chrome 预览 Word 报告,Word 端和设计器端都可以直接预览报告的效果,入口分别如下:
3.6.1 Word 端
点击「FineReport」加载项下的「保存」,再点击「预览」即可。
注:只要改动了 Word 想要预览时生效,就一定要先点「保存」再点击「预览」,否则改动不会生效。
3.6.2 设计器端
设计器端直接填报预览模板即可。
注:必须是填报预览,其他预览方式不支持。
3.7 导出Word
制作好的报告在预览时,支持原样导出为 Word 文件,操作方法如下:
1)设计器菜单栏点击「模板>模板Web属性」,将「使用新插件导出」添加到填报预览页面的工具栏,如下图所示:
2)预览时点击左上角「Word导出」即可,如下图所示:
注:设计器自带的导出功能是不支持导出资源的,不要用自带的导出功能。
4. 资源插入方法编辑
4.1 插入公式
把光标放在要插入公式的地方,点击左上角「公式」按钮,光标处会出现{{=}},在等号后面输入公式即可。如下图所示:
4.2 插入单元格
可以用公式按钮,也可以直接手写,在{{=}} 的等于号后面写单元格即可,如下图所示:
4.3 插入数据列
注:仅支持挂载到数据决策系统中报表的数据列,和服务器数据集。
1)登录账号打开需要编辑的报表,选择工具栏中的「数据列」按钮,可以在页面左侧的「资源中心」查看服务器内的所有数据列,如下图所示:
2)光标放置在需要引用数据列的位置,再选择需要引用的数据列,双击即可引用对应的数据列,如下图所示:
4.4 插入报表区域
报表区域其实就是表格,把光标放在要插入的地方,点击左上角「表格」按钮,可以在页面左侧的「资源中心」查看服务器内的所有表格,
选择需要插入的表格,双击对应的 sheet 名称,在弹出的「选择表格区域」对话框内输入插入的表格位置,选择「表格设置」,点击确定即可,如下图所示:
注1:表格所处单元格需要填写大写的英文字母和整数。
注2:仅支持挂载到数据决策系统中报表区域。
4.5 插入自定义参数
可以直接在 Word 中自定义参数,这样下文可以直接引用这个参数,这样就不用进行二次复杂计算了。
这个参数可以直接用公式来定义,如下图所示:
预览效果如下图所示:
4.6 插入图表
注:仅支持挂载到数据决策系统中报表的图表。
把光标放在要插入的地方,点击左上角「图表」按钮,可以在页面左侧的「资源中心」查看服务器内的所有图表,选择需要插入的图表,双击对应的图表名称,即可插入图表,如下图所示:
4.7 参数面板查询
在报表中添加参数,然后在参数面板,给参数添加控件,实现查询效果,保存报表,如下图所示:
Word 中插入报表区域,参数面板查询时,左侧 Word 内容预览区域也会跟随改变,效果如下图所示:
4.8 插入动态图表
点击「动态图表」,在弹出的对话框中选择「打开报表」,选择对应的报表,点击确定,选择图表所需要的数据并设置「分类」、「系列」
「值」,确定后会默认展示为饼图,点击「更改图形」选择自己需要的图形即可,保存后重新打开报表进行预览即可看到制作好的图表,如下图所示: