数据方报表使用手册
(V1.1)
1 系统简介
1.1
数据方报表系统有哪些功能？
数据方报表系统是一个完整的BI报表解决方案。可实现报表的制作、用户权限控制，数据同步和数据推送等功能。
实时报表：用户访问报表的时候实时从数据库查询，可设置页面自动刷新
条件报表：默认查询全部数据，可以任意结果字段做为条件查询数据，可设置条件数量
参数报表：打开报表时默认不查询，至少输入一个查询条件才能查出结果。通过参数定义哪些字段做为条件，可用作数据分析
图形报表：支持echarts的所有图表，通过代码可制作复杂的图形报表，可制作有一定交互式功能的图表
导出功能：所有表格形式报表均可点击字段名进行排序，可导出Excel和csv文件，可导出百万级数据量
数据填报：通过数据填报，能很轻易制定数据指标或分享表格数据，导入EXCEL
自定义报表：自定义报表能将公司开发的报表或开源报表、商业报表很方便的集成到报表平台中使用
邮件报表：扩展功能中可使用邮件报表，按天或按周定时推送数据（支持hive等大数据环境数据）
数据同步：扩展功能中可使用数据同步功能，将数据查出后同步到相同数据库或不同数据库
其他功能：如有需要，可以定制开发其他功能，系统支持功能扩展
云端使用地址：http://www.shujuf.com，需要自己去注册账号
报表客户端演示地址：http://www.shujuf.com/report/shujuf/login.html
测试账号：test@shujuf.com 密码：123456
1.2
使用中遇到问题时的联系方式？
QQ：343196832
我们会在第一时间回复并协助解决问题
2 功能说明
2.1 用户注册
开始使用前，需要注册一个报表端管理账号
一、进入首页点击注册按钮（网址：www.shujuf.com，如果部署在自己的服务器上，请使用服务器上的实际访问地址）
二、在界面上按要求输入注册信息
2.2 配置数据源
一、进入数据管理-数据源管理
二、新增数据源，数据库类型按需要选择MySQL或Oracle
三、测试数据库连接
点击修改按钮或删除按钮可以修改或删除数据源
2.3 创建报表
2.3.1实时报表
一、新增实时报表
数据源：选择要使用的数据源
视图：可以是视图名或表名，或查询代码块
报表宽度：不填时系统自动优化宽度，填具体数值时按数值的像素限制报表宽度
刷新时间：不填写报表不刷新，输入时间间隔，报表页面会按此间隔自动刷新
二、预览实时报表数据
点击预览按钮可预览报表数据，预览的数据为前100条记录
三、点击修改或删除按钮修改或删除实时报表，点击下载按钮可导出报表配置，在实时报表列表中点击字段名称可对列表排序，比如点击
‘报表编号’
2.3.2条件报表
新增条件报表
条件报表和实时报表相比，多了一个条件数，条件数为报表端显示的条件数量
2.3.3参数报表
新增参数报表
参数报表中可设置报表端显示的条件数
参数报表和条件报表的一个区别主要是sql代码
参数格式：${显示的条件名称@查询代码条件字段; 显示的条件名称@查询代码条件字段;…}
示列：
SELECT
a.餐厅ID,a.餐厅名称,sum(到店顾客总数) uv,sum(下单顾客数) 订单
FROM
test.data1 a
where ${统计日期@a.统计日期;餐厅所在城市@餐厅所在城市;uv@到店顾客总数}
group by a.餐厅ID,a.餐厅名称
提示：可使用如 日期@date(created)
这种格式，可使用复杂表达式
2.3.4图形报表
一、新增图形报表
新增图形报表后，可以在修改处设置子图表
二、新增图形报表的数据表，数据表的增加方法和实时报表差不多，增加后可以预览数据表数据
三、新增子图表
宽度：子图表是 独占一行，还是不独占，不独占时两个子图表会在同一行显示
高度：1大，2一般，3小
数据表：选择相应的数据表可以预览数据表数据
图表脚本：输入Echarts的option,下面会给出示例，更多可参考网址
http://echarts.baidu.com/examples.html
优先级：1-1000，越大排序越后
提交类型：选预览时提交显示预览效果，选新增时提交会保存子图表
Echarts代码示例：
{
title:{ text:'图表测试1'
},
tooltip:{},
legend:{
data:['销量']
},
xAxis:{
data:${4.店铺ID}
},
yAxis:{},
series:[{
name:'销量',
type:'bar',
data:${4.金额}
}]
}
参数格式：${数据表ID.数据表字段名称}
说明：1）直接用 { option代码 } 这种格式 ，“option=” 不用写，“myChart.setOption(option);” 代码可以省略不用写
2）{ option代码 }; 后可以继续写js脚本或函数
3）若要自定义option，可以在代码前使用 {}; 然后就可以自己写js代码或“option=”代码了
4）默认图形报表一行最多两个chart，可以利用js修改div的css来实现高级布局，也可以利用js实现动态加载数据
5）默认没有加载地图json，可以按需加载地图json，chart的div ID规则：char+子图表ID，加载json后需要自己实现setOption方法
$.get('/json/china.json', function (chinaJson) {
echarts.registerMap('china', chinaJson);
myChart= echarts.init(document.getElementById('chart57'));
myChart.setOption(option);
});
2.3.5自定义报表
如果想引入外部的报表页面或程序功能，可使用自定义报表。
默认自定义报表在报表端打开，也可以以弹出形式在新窗口中打开，只要勾选上 “新窗口中打开”
报表设计器
程序集成了报表设计器，报表设计器的使用参考文档：报表设计器用户手册.chm
新建好的报表模板拷贝到目录 shujuf\reportlets 下，然后增加自定义报表，自定义报表访问路径为 /reportviewer?file=reportlets/test1.xml test1.xml为模板名称
只有在报表端登录后，才能在线预览或打开刚配置好的自定义报表。
2.3.6数据填报
数据填报功能，会把数据库表名字段自动映射，并在填报页面显示
需要注意的地方：
1） 要填报的数据库表名使用中文字段，因为是自动映射，在前端才会以中文显示
2） 要填报的数据库表名第一个字段是主键或唯一标识，否则会造成填报数据可能不准确
2.3.7权限管理
新增权限组
把新建的报表加入到相应权限组
2.3.8报表用户
新增报表用户，并授予相应权限组权限
登录名：请输入邮箱作为登录名
2.3.9其他设置
报表端名称：报表端显示的logo名称
报表端目录：报表端地址目录
设置提交成功后，下面的链接就是报表客户端访问地址
2.3.10报表设置补充
一、邮件报表推送和数据同步功能，使用方法请联系咨询邮箱：343196832@qq.com
二、报表管理端查询技巧
当报表和用户数量特别多时，查找一个报表设置和用户信息会比较难找，可以借助浏览器的查找功能（Ctrl+F）
2.4 报表客户端使用简介
一、报表端登录
提示：可以在电脑端和移动端（手机、ipad等）进行访问
二、密码修改
登录后点击右上角的用户名，进入账户安全可修改密码
三、报表基础使用
1） 点击字段名可排序
2） 点击下载按钮可导出Excel和csv文件
3） 点击最下面的列表框，可选择每页显示的记录数
四、报表查询功能
条件报表和参数报表支持自定义查询功能
选择条件字段和表达式，输入条件内容后，可按回车或点击查询按钮进行查询
五、图表使用
图表中有下载按钮的，可以下载图表，也可以通过截图的方式自助截取图表
点击标示中的图例，可以选择查看和隐藏相关数据
更多图表使用，请参考：http://echarts.baidu.com/index.html
