以前写了一个简短的修改润乾文件的简记，今天有空来写一下新建润乾报表文件。

先说新建的整体流程如下：
1.新建数据源并连接(以前已建过或不需从数据库取值则可省这一步)
2.新建报表
3.定义数据集
4.定义单元格表达式(可自动生成表达式)
5.预览发布

最主要的就第三四步骤，下面开始详细讲解一下。
1.新建数据源并连接
先打开润乾软件，主界面如下图

第一二行分别是菜单栏和工具栏，工具栏和excel表格的工具栏是一样的，没有的可以去菜单栏下拉找找看看，熟悉一下这些按钮的作用。当然刚打开软件是都灰色的按钮， 只能先新建/打开文件或者配置数据源。

1.1 新建数据源： 菜单栏点击配置， 倒数第三个 数据源点击

1.2 左边是软件默认的两个数据源，可以不管他，右边竖排按钮是对左边选中的某一个数据源进行操作。这里我们先新建一个，下一界面是选择数据库类型，根据自己的数据库选择（咱常用的mysql，oracle都是属于关系型）。下一界面是数据源配置了

1.3 数据源名称随便起个都可以，数据库类型根据自己的选（我这用的是oracle为例）。驱动程序和数据源url都是下拉框，选了数据库类型后者两自然下拉只有一个选项。这里最主要的就是改一个数据源url里面的IP地址， 端口、数据库名，以及下一行的用户名和密码。
1.4 点击确定后自动回到1.1的那个截图，左边会多出一个刚才新建的数据源，选中点击右边的连接。

2.新建报表
2.1 方法1：直接点击工具栏第一个快捷按钮，新建一个空白的10行10列报表。
2.2 方法2：点击菜单栏文件–>新建报表

数据源：填写第一步新建的那个数据源名称也可以空着不写
数据集名称：就是你本次查询出的数据集合列表，可以默认也可以改一下
数据集类型：根据自己的查询sql语句来选，一般的查表用默认的sql检索即可
生成空白报表按钮：点这个和方案1是同样的效果，直接就新建了空白的10行10列报表
下一步按钮：是做什么的呢，是填写sql语句和sql中需要的参数。

2.3 这个界面前面5个选项如果不可操作，说明数据源有问题。这5个就读取数据库的东西让你点击选择，最后自动组成sql语句在语法选项里面。我是事先就写好了sql，把写好的查询sql粘贴到语法选项下面， where条件后的参数统一用问号代替。查询的字段可以用别名也可以不用别名。粘贴了sql后，前面的5个选项才可以看到东西了，类似分解了你粘贴的sql。
另外，如果步骤2.2的数据集类型选择的是 复杂sql 选项，则此界面就只有两个菜单选项了： 定义（同 语法 选项，粘贴sql用的）和参数（同上） 这两个，就没有前面5个让你点点选选自动组成sql了。

select id as id,name as name,age as age, regmbl as reg_mobile, tdate as reg_date,ttime as reg_time,status as usr_sts 
from t_user
where status = ? and age = ?

2.5 然后配置sql的传参，点击参数选项

点击增加按钮， 右边就会新增一行 参数表达式 这列为arg1的数据，把这个arg1改成你想要的名称。这个arg1是什么呢， 就像Mapper文件里面的where status = #{usr_sts}一样。
然后，你的sql里面有多少个参数（也就是多少个问号），这里就要新增多少行，而且区分顺序（可以选中行点右边的上移下移）。因为这儿的原理就是把这里配置的参数按顺序取来逐个去替换前面sql里面的问号，所以是区分顺序的。当然sql如果不需要传参的，就不需要新增了，这一步也可以省略。
2.6 最后可以点击确定了（若语法里的sql没写，点击确认是不起作用的），去下一个界面

这个界面的字段顺序是按你写的sql顺序来的，也就是表头的列顺序，可以通过上移下移按钮调整顺序，点击生成网格报表按钮就自动生成好表格了。如下图。

报表定义这个选项下面是用来是否显示某些字段， 默认勾选全部都显示， 去掉勾选的字段在生成的表格时就没这一列。如上图我是把 name 这个字段去掉了勾选所以就没了name这一列。

2.7 修改表头
自行把第一行的表头改成中文的，点击工具栏，设置加粗、居中、背景颜色黄色等等，这个和excel表格的操作一样的，不说了

3.定义数据集
上面的2.3这个步骤开始，其实已经是数据集的工作了。但如果查询语句需要传参进去的，那就还需要定义好数据集里的参数名称才能正常使用查询语句。这一步的作用有点类似java里面定义变量， int age； String name； 不然步骤2.5就找不到这个变量参数。

3.1 操作步骤：点击配置 ，第一个选项 参数，出现下图界面。点击新增按钮。左边就多出一行，去修改。
名称：就是步骤2.5配置参数时那些名称（2.5中有多少个不同名的参数这里也要新增多少行，一一对应）
描述：即 名称 的中文描述
字段类型：默认字符串，可按需改

3.2 编辑数据集。比如步骤2.1直接新建一个空白报表，然后在来配置（编辑）数据集 或者需要修改sql语句。
点击配置，点第三个菜单 数据集，出现下面界面

点击编辑按钮， 出来的界面跟新建时步骤2.5的界面是完全一样。想改什么就改
点击数据浏览按钮，出来的界面和3.1的界面是一样的。但只能看不能改，要改就按3.1再来一遍

4.定义单元格表达式
报表的第二行，新建报表自动生成都有表达了就不用管。若是直接新建一个空白报表就完全是空白没表头和表达式的需要自己手动加。
4.1 单元格的基础表达式：
一般是 =数据集名称.select(字段名)。如 =mydata.Select(ID) （mydata这个数据集名称是2.2的时候你自定义命名的）
也可以是=数据集名称.字段名。比如mydata.NAME
注：select status as usr_sts from... 应该是mydata.usr_sts而不是mydata.status，即有别名的用别名

4.2 单元格其他表达式：
自增序号：给上述表格增加一列自增的序号，方法如下。
点击第一列任意位置，鼠标右键插入列(插入列是在选中的单元格前面插入一列，追加列是在后面追加一列，行如是)。编辑好表头和设置一下单元格边框样式，第二行的单元格写上 =&B2，表示是以B2这个单元格数据作为基准自增。右边圈出的地方，扩展–左主格，这里一定要填上B2，不然导出数据的时候会报错。

此外，自增也可以用函数to或者seq，具体用法
to(1,5) 等同list(1,2,3,4,5)
to(1,10,2) 等同list(1,3,5,7,9)
seq() 等同 list(1,2,3,4,5…)
这个to就要指定序号的上限，所以不如=&B2这个写法好。

合并单元格：和excel操作一样的，合并按钮在菜单栏的 对齐方式 和 字体 设置之间，有一个字母a的按钮

字段翻译转义：状态、性别等字段在数据库存储的是数字或者字母，如何要显示成中文。先选中单元格，如4.2截图右边圈出处，依次点击 值– 显示值， 在显示值后面输入map(list(“S”,“L”,“C”),list(“正常”,“锁定”,“注销”)) 。 第一个list里面是数据库的枚举值，第二个是一一对应的翻译成中文名称

5.预览发布
完成后，点击菜单栏的快捷按钮 预览 或者 点击工具栏的 本地应用 选 预览，就可以看到网页版的数据报表了。

更多的用法可以见菜单栏的帮助，有说明文档。