1.1 版本说明

注1：该功能只支持普通报表，也就是 .cpt 报表。

注2：本文是对 Word 报告插件的基本介绍，只涉及基本开发流程，如果想要深入了解更多开发要点，请您学完本文后移步：Word报告开发须知和经验

1.2 应用场景

场景一：

将数据分析的结果转成 Word 报告是比较常见的业务需求，但是如果直接将报表导出为 Word 有时候并不合适。

因为正式的报告其实对内容和排版都是有较高要求的，比如想要在报告里面加描述性的语句来对指标进行分析，或者对字体和段落格式有固定要求。

如果直接将报表导出为 Word ，这个 Word 文件只有报表自身的内容，且 Word 格式和排版都是默认的，无法控制。

场景二：

报告中涉及到大量的数据指标，如果每次都要手动去改这些数字，麻烦不说还容易出错。

例如下图的空气质量监测报告，其中圈出是数据指标，每个月都会改变。怎么可以让这样的报告每个月自动生成呢？

FineReport方案：

FineReport 新推出的 Word 报告插件采用「WPS+设计器」的设计模式。

设计器里的数据集字段、参数、公式、图表、表格等称之为资源，这些资源的准备或设计都是在设计器里面完成。

WPS 里面可以直接插入这些资源，然后对这些资源的格式和排版进行调整，进而实现导出固定格式的 Word 文件。

在预览 Word 报告模板时，可以直观看到报告的最终效果，且支持原样导出该 Word 报告。预览效果如下图所示：

1.3 教学视频

2.1 获取安装包

1）扫码添加工作人员获取插件安装包，或您可以联系技术支持获取安装包

2）若您已安装插件，在使用期间遇到任何需求或问题，也可以扫码添加工作人员进行沟通或联系技术支持获得帮助。

技术支持联系方式如下：

在线QQ：800049425

热线电话：400-811-8890转2

2.2 安装插件

得到插件安装包后直接本地安装即可。

设计器插件安装方法参照：设计器插件管理

服务器安装插件方法参照：服务器插件管理

安装完成后登录数据决策系统，选择「管理系统>Word插件管理」，点击「FineReport」,弹窗「安装成功」即可完成安装，如下图所示：

插件安装完成后，Word 报告整体制作流程如下图所示：

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 端打开这个模板，对原来的设计进行修改。

注：2.0.2 及之前版本插件需要登录数据决策系统，将新建的模板挂载到数据决策平台中才可引用资源。

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报告导出及打印。

3.8 设置定时调度任务

可参考：word报告设置定时调度任务。

4.1 插入公式

把光标放在要插入公式的地方，点击左上角「公式」按钮，光标处会出现{{=}}，在等号后面输入公式即可。如下图所示：

4.2 插入单元格

可以用公式按钮，也可以直接手写，在{{=}} 的等于号后面写单元格即可，如下图所示：

4.3 插入数据列

1）登录账号打开需要编辑的报表，选择工具栏中的「数据列」按钮，可以在页面左侧的「资源中心」查看当前模板数据列以及平台挂载模板的数据列，如下图所示：

2）光标放置在需要引用数据列的位置，再选择需要引用的数据列，双击即可引用对应的数据列

4.4 插入报表区域

报表区域其实就是表格，把光标放在要插入的地方，点击左上角「表格」按钮，可以在页面左侧的「资源中心」查看当前模板表格以及平台挂载模板的表格，选择需要插入的表格，双击对应的 sheet 名称，在弹出的「选择表格区域」对话框内输入插入的表格位置，选择「尺寸」和「预览/导出时展示形式」，点击确定即可，如下图所示：

注：表格所处单元格需要填写大写的英文字母和整数。

4.5 插入自定义参数

可以直接在 Word 中自定义参数，这样下文可以直接引用这个参数，这样就不用进行二次复杂计算了。这个参数可以直接用公式来定义，如下图所示：

预览效果如下图所示：

4.6 插入重复动态文本

在 Word 中添加重复动态文本控件，可以将固定内容的重复一定的次数，控件内容可以为固定文字，FineReport公式，数据列，自定义参数等。例如希望将上次的计算结果165重复显示3次，在 Word 中添加重复动态文本控件后，输入重复的次数，并在控件写入：上次的计算结果{{==$abc}}，如下图所示：

4.7 插入图表

把光标放在要插入的地方，点击左上角「图表」按钮，可以在页面左侧的「资源中心」查看服务器内的所有图表，选择需要插入的图表，双击对应的图表名称，即可插入图表，如下图所示：

4.7 参数面板查询

在报表中添加参数，然后在参数面板，给参数添加控件，实现查询效果，保存报表，如下图所示：

Word 中插入报表区域，参数面板查询时，左侧 Word 内容预览区域也会跟随改变，效果如下图所示：

4.8 插入动态图表

点击「动态图表」，在弹出的对话框中选择「打开报表」，选择对应的报表，点击确定，选择图表所需要的数据并设置「分类」、「系列」

「值」，确定后会默认展示为饼图，点击「更改图形」选择自己需要的图形即可，保存后重新打开报表进行预览即可看到制作好的图表，如下图所示：