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