反馈已提交

网络繁忙

Word报表插件

  • 文档创建者:Leo.Tsai
  • 编辑次数:32次
  • 最近更新:Leo.Tsai 于 2022-01-10
  • 1. 概述

    1.1 版本说明

    报表服务器版本插件版本自定义加载项版本系统要求office要求功能变动
    11.0
    1.0.12
    1.0.0
    Windowsoffice 2013 及以上 / WPS 2019 专业版新增 Word 报告功能

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

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

    1.2 应用场景

    场景一:

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

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

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

    场景二:

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

    例如下图的空气质量监测报告,其中红字是数据指标,每个月都会改变,黑字都是固定格式的套话,不需要改动。怎么可以让这样的报告每个月自动生成呢?

    FineReport方案:

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

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

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

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

    268ADBD2-081D-46F6-97C5-7F7250C4946F.GIF

    2. 环境准备

    使用 Word 报告功能需要给报表服务器安装一个插件,同时还要给 office 软件安装一个自定义加载项。点击此处获取两个安装包:FineWord

    2.1 安装插件

    得到插件安装包 fine-plugin-com.fr.plugin.widget.word 后直接本地安装即可。

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

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

    1630986219423803.png

    2.2 安装自定义加载项

    得到 fineWord.exe 后,直接双击安装即可。

    1634872804206392.png

    打开 Word 软件,上方功能区出现 FineReport 即代表加载项安装成功,如下图所示:

    1630986304588160.png

    3. 报告制作流程

    3.1 配置服务器地址

    新建一个空白 Word 文档,点击功能区域的FineReport,再点击服务器配置设置项,弹出的FineReport地址对话框填写报表服务器地址。

    下图连接的是设计器内置服务器,地址为:http://localhost:8075/webroot/decision,如果是远程设计环境,需要填入远程设计服务器地址。最后点击保存即可。

    这样 Word 就已经连接到了报表服务器,后面可以跟设计器一起联动设计报告。

    1630995056218907.png

    3.2 登录服务器

    上面配置服务器地址点击保存后,会自动弹出登录界面,也可以使用左上角的登录设置项进入登录界面。

    如果是远程设计,则账号的登录权限跟 远程设计权限 保持一致,无远程设计权限的用户无法登录,且提示:无远程设计权限,若要进行远程设计,请管理员开启权限后登录。

    登录的用户名和密码跟决策平台配置的用户名和密码相同,且登录时保持登录状态暂不可用,也就是每次重新打开 Word 后,要重新登录。

    1630995225693988.png

    登录后左上角登录变为注销,点击可注销账号。

    1639637239962504.png

    3.3 新建普通报表

    在设计器端准备数据集、参数、图表这样的资源,在 Word 端设计报告的内容和排版,这些都是保存到一张普通报表里面去的。

    创建普通报表时要从 Word 端创建,方法如下:

    点击FineReport」加载项下的保存,在报表工程下新建一个普通报表。选择报表路径并给模板命名后,点击确定,弹出上传成功对话框,表示模板创建成功。

    1630997614333193.png

    这时回到设计器,点击报表管理面板的刷新按钮,就可以看到新建的普通报表了。

    双击进入模板,可以看到 A1~K60 已经合并为一片区域。这个区域是 Word 占用的,预览模板时,可以在这个区域展示 Word 的实时内容。

    1630998348700136.png

    Word 设计的内容是保存到模板里面的,如果想要查看或修改已有模板的 Word 内容,可以直接从 Word 端打开这个模板,对原来的设计进行修改:

    1639637021905734.png

    3.4 准备资源

    在 test.cpt 中新建两个数据集:

    ds1 的 SQL 语句为:SELECT * FROM 销量

    ds2 的 SQL 语句为:SELECT SUM(销量) AS 销售总量 FROM 销量

    并在 L1~N2 区域设计一个表格,将数据集中字段拖到对应单元格中,如下图所示:

    1631000365412405.png

    普通报表中准备好资源后,一定要点击保存」报表,这样在 Word 中点击资源列表的刷新按钮,就可以让这些资源显示在资源列表处,如下图所示:

    注:也就是说只要在报表中改动了一些资源,想要在 Word 中刷新生效,就一定要先保存这张报表。

    1631002648543021.gif

    3.5 插入资源

    此处只展示往 Word 中插入数据集字段、公式、报表区域,其他类型的资源后面会介绍。

    首先是插入公式实现动态标题,让 Word 标题里的日期一直是今天,在正文处输入文本:{{=FORMAT(today(),"yyyy年MM月dd日")}}销售报告,文本中包含公式和普通文字。

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

    注:暂未支持所有 FineReport 公式,存在个别公式插入后不生效的情况。

    1631004466871502.gif

    插入数据集字段的方法:左侧资源列表将数据集展开,双击或拖拽字段,即可将字段添加到 Word 光标处,操作如下图所示:

    1631004700951324.gif

    可以将报表中一片表格区域插入到 Word 中。

    插入方法:把光标放在要插入的地方,点击左上角「报表区域按钮,弹出插入报表区域对话框,输入表格左右范围即可。操作如下图所示:

    1631005211787347.gif

    3.6 预览文档

    建议使用 Chrome 预览 Word 报告,Word 端和设计器端都可以直接预览报告的效果,入口分别如下:

    1)Word 端

    点击「FineReport」加载项下的「保存」,再点击预览即可。

    注:只要改动了 Word 想要预览时生效,就一定要先点「保存」再点击「预览」,否则改动不会生效。

    1631005696540740.gif

    2)设计器端

    设计器端直接填报预览模板即可。

    注:必须是填报预览,其他预览方式不支持。

    3.7 导出Word

    制作好的报告在预览时,支持原样导出为 Word 文件,操作方法如下:

    1)设计器菜单栏点击模板>模板Web属性,将使用新插件导出添加到填报预览页面的工具栏,如下图所示:

    Snag_6c46ed49.png

    2)预览时点击左上角Word导出即可,如下图所示:

    1638430324488400.png

    注:设计器自带的导出功能是不支持导出资源的,不要用自带的导出功能。

    4. 资源插入方法

    4.1 插入公式

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

    1631006962651816.png

    4.2 插入单元格

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

    1631007110839678.png

    4.3 插入数据集字段

    现在关联的那张报表里面添加数据集,然后保存这张报表,之后回到 Word 点击资源列表的刷新按钮,刷新后数据集就会出现在资源列表处。

    左侧资源列表将数据集展开,双击或拖拽字段,即可将字段添加到 Word 光标处,如下图所示:

    1631007333259563.png

    4.4 插入报表区域

    报表区域其实就是表格,把光标放在要插入的地方,点击左上角「报表区域按钮,弹出插入报表区域对话框,输入报表中表格左右范围。

    这样就可以把一片区域单元格插入到 Word 中,如下图所示:

    注:报表区域可以在其他 sheet 页设计,插入时可选择 sheet 页。

    1638431858194708.png

    4.5 插入自定义参数

    可以直接在 Word 中自定义参数,这样下文可以直接引用这个参数,这样就不用进行二次复杂计算了。

    这个参数可以直接用公式来定义,如下图所示:

    1631009077708455.png

    预览效果如下图所示:

    1631009206407306.png

    4.6 插入图表

    在关联的那张报表中设计图表,可以在其他 sheet 页设计,然后保存报表。

    1638431984826516.png

    回到 Word ,点击左侧资源列表的刷新按钮,在图表栏会出现图表资源,展开后双击将图表添加到 Word 中,如下图所示:

    注:图表资源只能双击不支持拖拽哦,这个跟数据集字段有区别,需要注意。

    1638432079483952.png

    4.7 参数面板查询

    给关联的那张报表添加参数,然后在参数面板,给参数添加控件,实现查询效果,保存报表,如下图所示:

    1631008380965566.png

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

    1631008297867957.gif

    5. 注意事项

    5.1 不同浏览器预览报告的差异

    使用不同浏览器预览 Word 报告模板时,发现效果不一样,以 Chrome 和 Microsoft Edge 为例,它们的预览效果分别如下:

    Chrome:

    Snag_142bb62.png

    Microsoft Edge:

    Snag_142c824.png

    可以看到一个是黑底一个是白底,而且上方阅读工具栏也不一样。

    Word 报告其实是采用 PDF 阅读模式预览的,因而会自动调用浏览器本身的 PDF 阅读模式,浏览器 PDF 阅读模式有差异,因而预览效果也有差异。

    另外上方的阅读工具栏是浏览器 PDF 阅读模式自带的,因而工具也有差异。

    5.2 IE浏览器预览报告的方法

    上面 5.1 提到了 Word 报告是采用 PDF 阅读模式预览的,但是 IE 没有 PDF 阅读模式,因而无法预览 Word 报告。

    想要使用 IE 浏览器预览报告需要借助 PDF 插件实现,IE 安装 PDF 插件的方法您可以检索网上的资料。

    附件列表


    主题: 报表应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

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

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭