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）新增「可重复动态文本」 |
1.2 应用场景
学习此文档前需要您先了解 Word 报告基本开发流程：Word 报告，本文主要讲解资源插入方式以及注意事项。
1.3 教学视频
2. 资源插入方式
2.1 插入公式
把光标放在要插入公式的地方，点击左上角「公式」按钮，光标处会出现{{=}}，在等号后面输入公式即可。如下图所示：
2.2 插入单元格
可以用公式按钮，也可以直接手写，在{{=}} 的等于号后面写单元格即可，如下图所示：
2.3 插入数据列
1）登录账号打开需要编辑的报表，选择工具栏中的「数据列」按钮，可以在页面左侧的「资源中心」查看当前模板数据列以及平台挂载模板的数据列，如下图所示：
2）光标放置在需要引用数据列的位置，再选择需要引用的数据列，双击即可引用对应的数据列
2.4 插入报表区域
报表区域其实就是表格，把光标放在要插入的地方，点击左上角「表格」按钮，可以在页面左侧的「资源中心」查看当前模板表格以及平台挂载模板的表格，选择需要插入的表格，双击对应的 sheet 名称，在弹出的「选择表格区域」对话框内输入插入的表格位置，选择「尺寸」和「预览/导出时展示形式」，点击确定即可，如下图所示：
1）「尺寸」若设置为自定义大小则在word内生成占位图，可自行调节占位图的大小与位置。预览后的结果表格，与占位图的大小与位置保持一致。若设置为表格原尺寸则表格尺寸保持不变。
2）引用的表格资源中「预览/导出时展示形式」设置为表格，则支持导出后对表格二次编辑。若设置为图片导出后表格显示为图片，不支持导出后对表格二次编辑。
注1：表格所处单元格需要填写大写的英文字母和整数。
2.5 插入自定义参数
可以直接在 Word 中自定义参数，这样下文可以直接引用这个参数，这样就不用进行二次复杂计算了。这个参数可以直接用公式来定义，如下图所示：
预览效果如下图所示：
2.6 插入重复动态文本
在 Word 中添加重复动态文本控件，可以将固定内容的重复一定的次数，控件内容可以为固定文字，FineReport公式，数据列，自定义参数等。
注：重复动态文本尽量避免放在段落中间。
1）控件内容为数据列：
例如展示将数据集中销售员的销售总量，首先现在报表中计算销售的销售总量，如下图所示：
添加可重复动态文本，在重复次数中输入需要重复的次数，输入：count(L1)，支持公式和数据，如下图所示：
在控件内输入：{{=VALUE('ds1','销售员')}}的销量总量为{{=O1!}}，保存后预览如下图所示：
2）控件内容为单元格：
例如需要将华北和华东的销量柱形图分别展示，首先在 Sheet2 中合并 B1~E8、F1~I8 单元格分别插入两张按产品分类的销量柱形图，如下图所示：
在 Sheet1 的 L1 单元格中拖入地区数据列，M1中插入公式：IF(L1="华北",'{{~1:B1:E8}}','{{~1:F1:I8}}')，如下图所示：
在 Word 中插入重复动态文本控件，重复次数为两次，输入内容为：如果地区为华北则显示华北图表，反之显示华东图表：{{=M1!}}，保存后预览：
2.7 插入图表
把光标放在要插入的地方，点击左上角「图表」按钮，可以在页面左侧的「资源中心」查看服务器内的所有图表，选择需要插入的图表，双击对应的图表名称，即可插入图表，如下图所示：
2.7 参数面板查询
在报表中添加参数，然后在参数面板，给参数添加控件，实现查询效果，保存报表，如下图所示：
Word 中插入报表区域，参数面板查询时，左侧 Word 内容预览区域也会跟随改变，效果如下图所示：
2.8 插入动态图表
点击「动态图表」，在弹出的对话框中选择「打开报表」，选择对应的报表，点击确定，选择图表所需要的数据并设置「分类」、「系列」
「值」，确定后会默认展示为饼图，点击「更改图形」选择自己需要的图形即可，保存后重新打开报表进行预览即可看到制作好的图表，如下图所示：
3. 注意事项
3.1 公式书写要求
1）Word 里面插入公式时不需要格式嵌套
例如：插入一个单元格的写法是：{{=M3}}
此时如果想要对这个单元格求和，正确的写法是：{{=SUM(M3)}}
求和公式括号里面的单元格不要再加公式格式了，也就是不要错写成：{{=SUM({{=M3}})}}
2）Word 里面插入公式是支持引用层次坐标的
例如：{{=O2[N2:1]/SUM(O2[!0])}}
3.2 资源存放位置
准备资源时，可以引用当前报表中的数据列、图表、表格等，以及支持引用挂载到数据决策系统中的模板内容。
3.3 重复动态文本控件说明
1）重复次数仅支持固定次数。
2）控件中的公式默认不参与重复，若想重复参数需要添加=，例如自定义参数为：{{=$a}}，在控件中引用需要输入：{{==$a}}
3）重复文本最好单独成行，不要跟其他文字在一个段落中间使用，可能出现换行问题。
4）使用添加数据列的单元格默认采用最后一个数据，例如： 如设计器内 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 和数据集丢失。