一飞开源
阅读1441

[开源]以复杂中国式报表为核心目标的制作、运行工具、数据大屏

一飞开源，介绍创意、新奇、有趣、实用的开源应用、系统、软件、硬件及技术，一个探索、发现、分享、使用与互动交流的开源技术社区平台。致力于打造活力开源社区，共建开源新生态！

一、开源项目简介

CellReport 是一个以 复杂统计报表 为核心目标的制作、运行工具。你可以使用数据库、excel文件、api服务、已有报表等为数据源，通过内置的集合函数组织数据，以类excel界面设计最终呈现结果。

CellReport 诞生的初衷是为了解决日常快速制作统计报表的需要。在总结了市面上各种报表软件的前提下，结合集合运算的思想，使得报表制作人员抛弃使用存储过程加工数据的方式，专注于每一类指标的加工，然后在报表设计界面，通过集合函数组织数据，极大得方便了报表的制作和维护。

二、开源协议

使用Apache-2.0开源协议

三、界面展示

部分例图

四、功能概述

CellReport 是一个以复杂中国式报表为核心目标的制作、运行工具。支持数据看板、大屏制作。你可以使用数据库、excel文件、api服务、已有报表等为数据源，通过内置的集合函数组织数据，以类excel界面设计最终呈现结果。

主要特点：

  • 支持所有常规的清单、分组、交叉。
  • 多源、分片
  • 多数据集的集合运算
  • 单元格扩展、引用
  • 内置类js语言引擎
  • 丰富的函数定义
  • 可自定义扩展函数
  • 页面元素丰富。预定义有报表组件、echart组件、数据展现组件等
  • 灵活的报表元素间的数据引用，局部报表刷新设置方便
  • 组件报表引用、以及对其他报表软件制作的报表引用（专业版提供）

主要特性

高效 灵活

内部以专门为报表设计的 类js语言 为中心，以最少的配置帮助你专注于报表开发。

Net6驱动 高性能

享受 Net6 的高效运行，占用极少的内存（300M左右），运行各种复杂的中国式报表。

中国式报表

专为常年制作报表的人士提供基于集合运算的多数据集支持，实现高效、快捷的完成报表制作。

多组件展现

基于dashborad 的单页面多组件展现，预置了30 多个为展现数据定制的组件（echart图、avue数据展现等）。

自由扩展

报表引擎可添加自定义函数，前端可自定义展现组件，通过内置语言自由扩展认证和权限接入。

通用数据源

数据源支持各种.net支持的数据库、excel文件、api服务、本软件制作的报表、其他报表软件的报表（如：reporting service 等）

五、技术选型

技术实现

前端设计器采用基于vue、luckysheet、echarts等前端技术实现的网页方式 后端报表引擎核心基于netcore6 实现

它是如何工作的？

报表运行时，会首先以并行方式将所有数据集的数据取到运行环境，然后根据报表设计中预定义好的公式做数据的合并、运算，最终数据以json方式传给最终展现页面，前端页面根据json结果呈现最终展示。

报表运行环境内置了类js语言环境，所有运算都是以该语言为核心。通常制作报表，我们只需要记住10个左右的函数，以及+-*/ ，就足够我们制作复杂的统计报表了。

运行环境提供了很多可以拦截接入自定义控制的地方，如：报表运行前的通用检查、控制数据集的数据是否回传前端等。前端展现可以动态插入自定义css、js 。

前端是以vue 为基础，通过template-compiler模板编译器，可自由控制echart、数据展现等组件的显示样式。

后端运行的基础环境是net6。内存效率利用极高，仅需300M左右内存。内部大量异步任务和延迟返回等技术，执行效率基本和原生手写加工数据程序的运行效率相当。

我们可以通过实现FunctionUnit接口实现系统没有预定义的函数，也可以用内置语言实现一些简单的函数扩展。

需要安装的软件

  1. 下载安装NET6 SDK6 或 ASP.NET Core Runtime 6. Download .NET (Linux, macOS, and Windows)
  2. 下载安装redis（可选）。
  3. 访问一飞开源：https://code.exmay.com/ 下载本项目 。

运行和配置

假设解压安装到了d:\cellReport。

  1. 执行 start.bat
  2. 浏览器输入地址: http://127.0.0.1:5000
  3. 缺省用户名密码:admin/database!123 。管理员用户在appsetting.json中存有（最后面可以找到），可以自行修改。

报表组管理

缺省已经有了一个default组和example组。第一次登录，选报表组管理做基本的配置报表存放路径和数据库链接。可以根据不同的应用建立不同的组。报表组可以添加协助管理人员，多个用户中间用英文逗号分割。

当前预安装的数据库驱动程序有:sqlServer、sqlite、Mysql、Pgsql、odbc。需要其他驱动的自行下载安装。

sql server 连接串格式
Data Source=ip地址;Initial Catalog=数据库名字;Persist Security Info=True;User ID=用户;Password=口令;Min Pool Size=1;Max Pool Size=50;Connect Timeout=15000;Application Name=报表连接

oracle 连接串 格式
Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=ip地址)(PORT=端口))(CONNECT_DATA=(SERVER = SERVER名字)(SERVICE_NAME = 数据库)));User Id=用户;Password=口令;

sqlite 连接串 格式
Data Source=E:\my_app\报表源码_2020\a_new_lib\test.db

MySql 连接串 格式
Database=dbname;Data Source=x.x.x.x;Port=3306;User Id=xxx;Password=****;Charset=utf8;TreatTinyAsBoolean=false;

pgsql 连接串 格式
server=ip地址;port=5432;uid=用户;pwd=口令;database=数据库;Pooling=true;

配置完毕后，按F5 刷新页面，点报表目录，正常的话，这是应该能看到所有的测试报表了

本软件使用到的的第三方软件，在此一并致谢

前端： luckysheet ，vue ，element-ui, avuejs 后端: antlr3

制作统计报表，往往不是一个sql语句能搞定的:

  • 有些报表需要从多个数据库取数；
  • 有些虽然是从一个数据库取数，但数据是分散在数据库的很多表中，需要多个sql语句组织有关数据，然后按照某些关系归并在一起；
  • 有些报表虽然是一个基础表，但对该表中的数据要经过不同的加工，一句sql语句不能将所有的报表要展现的数据组织完毕。比如统计报表中常见的本期、累计、完成比例。在数据库中，基础数据是按照一天天的发生数存在表中，本期为月初到查询日期的累计发生数数，累计为从年初到查询日期的累计发生数，完成比例为累计除上计划数，计划数肯定要在另一个表中单独存放。本期和累计虽然都是一个表，很明显因为条件的不同，一句sql不可能做到同时取出本期和累计。这样的统计报表最少需要3个sql取数才能将报表上所需要的数据全部取出，然后按照特定的条件（比如按机构）将三个数据集的归并，之后才能展现出正确的报表。
  • 传统的报表工具（如水晶为代表的国外报表工具），都是以单一数据集为基础的报表生成工具，如果你需要用到很多sql才能产生出一张统计报表，那么，你必须建临时表，通过写存储过程等办法，将分散在数据库中的数据组织到一个数据库表中，然后通过报表工具展现出来。这样的做法，也能解决中国式报表的生成问题，但报表的编写和维护量将非常大，而且报表逻辑不直观，一旦客户需要更改报表格式和逻辑，将是一件非常痛苦的事情。对于这样的报表工具而言，做报表就是写程序，报表工具沦落为最普通的展现工具。
  • 现在国内有些报表工具也有很多号称支持多数据集，但在做这样的统计报表时，一般都是通过单元格的上下级关系将各个数据集联系起来，无论是在报表生成效率和直观易用方面，都比较差。
提示
在cellReport中，建设性的加入了关于集合的运算功能，可以对各个数据集按照指定的条件分组归并，从而极大的减低开发统计报表的难度。本报表软件的集合的运算包括：并集、交集、以及集合的减法。最常用的就是求集合的并集。

六、源码地址

源码下载

关注下面的标签，发现更多相似文章

一飞开源
发布了 篇专栏 · 获取点赞 · 获取阅读

评论

查看更多
相关推荐
关于作者
一飞开源
获得点赞 100
文章被阅读 1000
相关文章