一、安装/下载
强烈建议大家要是第一次使用的话使用最新版本,无他,功能多啊,不然后面使用很难受,老是需要更新!!!
项目gitee地址:https://gitee.com/anji-plus/report
项目github地址:https://github.com/anji-plus/report
项目文档:https://ajreport.beliefteam.cn/report-doc/
项目示例:https://ajreport.beliefteam.cn/index.html#/index
找到自己需要的版本直接使用 git clone 地址就好了,然后进行安装依赖npm i。
二、开发环境
官网说的是以下版本存在兼容问题,不要使用:
Node.js V16及以上
openJdk
Jdk 1.7及以下/11及以上(jdk11部分版本有问题)
Mysql 8.0(8.0.23/26版本没有问题,8.0.21版本存在问题),
其实前端要注意的地方也没啥,主要就是Node.js V16版本及其以下,其他的就没了。
三、文件初始化
官网说修改:目录地址:report-ui --> config --> prod.env.js,将BASE_API地址,改成自己后端服务所在机器的ip地址,
但是试用的时候偶尔会发现一点别的问题,启动不起来,所以建议大家修改两个地方:
report-ui --> config --> prod.env.js和report-ui --> config --> dev.env.js的BASE_API地址。
别的就没啥了,使用npm run dev将启动就好。
四、配置
我使用的是http的接口,所以不用配置数据源,直接配置数据集就好,方便快捷
相当简单,配置个名字,地址,点个数据预览,数据能出来说明就OK了。当然,你需要什么数据可以给后端说一下,一般是一个展示名字,一个名字对应的code,方便传值和联动!
我把联动也放在这个位置,联动比较重要,有些刚看文档的朋友可能看不懂,我在这写一下。
例如这是下拉框的数据:
[
{
"data_name": "北京",
"data_code": "beijing"
},
{
"data_name": "上海",
"data_code": "shanghai"
},
{
"data_name": "天津",
"data_code": "tianjin"
},
{
"data_name": "深圳",
"data_code": "shenzhen"
}
]
这是需要联动的组件:
condition是进行联动,往后端传的值,查询参数中配置的是默认的值,比如:你要是想默认是北京的数据,那这里的配置就是beijing,初始组件展示的值。
在下拉框的配置页面,组件联动–>新增,选择要进行联动的组件名,在vulue的位置选择对应的参数,我上面配置的动态参数是condition,那value的位置配置的就是condition,保存之后就可以进行联动了,很方便。
五、页面配置
配置页面的时候可以找一些素材,例如背景图,组件的背景框等,可以参照官方示例:https://ajreport.beliefteam.cn/index.html#/index
其余的都是自己要什么就配置什么了
六、常见的问题
1、同一个下拉框不要用一个数据源,可能会出现显示不出来的问题,建议每个下拉框配置一个数据源;
2、下拉框切换数据接口不生效时,建议重新配置,有时候不是很稳定;
3、页面数据量很大时,要把刷新时间调大一点,不然页面会很卡,服务器的压力也会很大;
暂时就是这么多的东西,如果在配置的时候还有哪些地方不太懂得话,可以看下官方文档,也可以私信留言,看到就会回复,也可以代邀请进官方群聊,直接与开发者对话。(不喜勿喷哈)