数据集

在所示的数据集设置窗口中点击【增加】按钮，弹出数据集类型对话框，如下图所示：  

选择“SQL检索”数据集类型，点击【确定】按钮，进入SQL编辑器界面，如下图所示： 

选择“指定模式”，通过“可选表名”框和“选中表名”框之间的箭头，在可选表名中选择数据表到选中表名中。  

切换到“数据字段“标签页，首先通过数据表下拉框选择对应的数据表，下面会列出对应数据表的可选字段，然后通过两个列表框之间的箭头，选择可选字段到选中字段中。  

切换到“计算列”标签页，通过编辑界面中间的箭头，选择所需要的字段到“计算列”编辑框中，自己编辑表达式。

比如：订单明细表中有单价与数量字段，希望在数据表里直接取出订单的单价与数量的乘积，则可以在计算列中编辑：订单明细.单价*订单明细.数量 as 总金额，如下图所示： 

切换到“检索条件”标签页，通过编辑界面中间的箭头，选择所需要的字段到检索条件编辑框中，自己编辑表达式。SQL语句中可以使用参数，在sql语法里，需要用到参数的地方写上问号。

比如：如果希望从订单表里取出订购日期是某一时间段内的订单，则可以在检索条件中编辑检索条件：订单.订购日期>? and 订单.订购日期<?。

如下图所示：  

切换到“排序”标签页，通过编辑界面中间的箭头，选择需要进行排序的字段到排序字段框中。

切换到“语法”标签页可以看到编辑好的SQL语句。在SQL语法里，需要用到参数的地方写上问号，比如我们在前面编辑的检索条件，用到了两个问号。如下图所示： 

切换到“参数”标签页，按照问号顺序，写入参数名或含参数的表达式（不用等号开头）。在这里不用考虑参数的数据类型，程序中会自动转换。如下图所示：  

数据集工厂侦听类，该类由IDataSetFactoryListener 接口来实现，如果数据集创建不需要做特殊处理，就不用设置该属性。

如果需要做特殊处理，则需要写一个数据集创建后处理类，用IDataSetFactoryListener 接口，实现它的public void beforeCreated(Context context, DataSetConfig dsc, DataSet arg2)及public void afterCreated(Context arg0, DataSetConfig arg1, DataSet arg2)方法,并将编译后的类带包路径放在应用的classes下。（注：在设计器中，请直接在润乾安装根目录下建立一个classes文件夹）

数据集记录行设置：用于控制数据集的按页取数。一般来说，起始行和结束行都是输入参数，通过参数来控制行号，如果输入常数，一般没什么意义。

起始行和结束行可用来人为控制分页，如果您的报表数据量比较大时，可以通过参数传递来改变起始行和结束行，通过按页取数的方式来减少数据量 。

根据需要填写数据集工厂侦听器类名，以及起始行和结束行。没有特殊需要，可不填。

点击【确定】按钮，回到数据集设置界面，如果希望给数据字段设置中文标题，可点击【别名】按钮，按照字段顺序为每个字段设置中文标题。

点击【确定】按钮，完成数据集定义。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“存储过程”数据集类型，点击【确定】按钮，进入存储过程数据集界面，如下图所示：  

切换到“参数”标签页，如下图所示：  

参数的顺序必须与问号的顺序保持一致，并指定参数模式。这里用到的参数必须在配置-参数中定义，并且在配置-参数中定义参数时指定对应的数据类型。

从上图可以看到，“参数定义”后有“结果类型”属性，如果“参数模式”为输入参数，选择“自动”就可以了，只要在配置-参数中定义参数时指定对应的数据类型即可。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“存储过程”数据集类型，点击【确定】按钮，进入存储过程数据集界面，如下图所示： 

切换到“参数”标签页，如下图所示：  

参数对应call Procname(?)中的?，参数表达式为：@arg2，arg2是我们在报表中定义的一个普通参数，它接收Procname存储过程中输出参数a的值。结果类型为字符串，因为我们的输出参数a为char类型，所以结果类型为字符串。参数模式为：输出参数。输出名称为：arg2，我们在报表中就用arg2来引用存储过程中的输出参数a 的值。

报表设计中需定义的参数：

报表设计

预览报表，在参数arg2中输入任何值，报表展示后，E2{}中返回的都是’aaa’，arg2已经被调用的Procname存储过程的输出参数重新赋值了。  

	注意
	存储过程可以没有输出参数，但是如果你的存储过程是将结果集返回给一个参数，则需要在配置-参数里定义该参数，并指定该参数的“参数模式”为“输出参数”。这个时候，如果你的数据库正好是oracle，则还需要将这个输出参数的结果类型设置为“游标”。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“复杂SQL”数据集类型，点击【确定】按钮，进入复杂SQL数据集编辑界面，如下图所示：  

在“定义”标签页中输入SQL语句，如上图所示：

同sql检索一样，在sql语法里，需要用到参数的地方写上问号，然后在“参数”标签页中按照问号顺序，写入参数名或含参数的表达式，如下图所示： 

	注意
	SQL语句中用到的参数要事先在报表参数中定义。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“Text文件”数据集类型，点击【确定】按钮，进入文本数据集编辑界面，如下图所示：  

点击【…】按钮选择area.txt文件所在的位置，也可以输入area.txt文件相对路径。

点击【确定】按钮既可完成Text文件数据集的建立。

TEXT 文件中的格式如下图所示： 

第一行为列名定义，第二行为列的数据类型定义，第三行开始是数据。

其中第一行和第二行都可以省略，如果省略列名定义，那么表达式里引用列时用dsn.#n的方式，n代表列号；如果省略列数据类型定义，那么数据类型全部默认为字符型。 数据类型的定义采用java.sql.Types里的标准定义。

列间分隔符为TAB键，即\t，行间分隔符为回车键，即\n。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“XML文件”数据集类型，点击【确定】按钮，进入XML数据集编辑界面，如下图所示： 

点击【…】按钮选择student.xml文件所在的位置，也可以输入student.xml文件相对路径。

点击【确定】按钮既可完成xml文件数据集的建立。

XML文件中的格式如下图所示：  

根节点为ROWS，根节点下第一个节点为列名定义，第二个节点为列的数据类型定义，第三个节点开始是数据 列名和列的数据类型都可以不定义，如果省略列名定义，那么表达式里引用列时用dsn.#n的方式，n代表列号；如果省略列数据类型定义，那么数据类型全部默认为字符型。 数据类型的定义采用java.sql.Types里的标准定义 一行数据为一个ROW节点定义

在中点击【增加】按钮，弹出数据集类型对话框。

选择“内建数据集”类型，点击【确定】按钮，弹出“内建数据集”窗口，在此窗口中我们可以定义内建数据集包含的字段和数据值。在“字段”标签页定义内建数据集包含的字段，点击右边的【增加】按钮，在左边的字段列表中就会增加一个字段的定义，可以修改字段名和字段的数据类型。假设我们定义姓名和年龄两个字段，如下图所示：

  

切换到“数据”标签页，点击右边的【增加】按钮，可以添加字段对应的数据值。如下图所示：

  

我们也可以把excel文件中已有的数据导入到内建数据集中。首先复制excel文件中的数据值，在内建数据集的“数据”标签页点击右边的【粘贴】按钮即可把excel文件中的数据导入到内建数据集中。

点击【确定】按钮，一个内建数据集就建好了。

可以把一个外部数据集转为内建数据集也可以把内建数据集还原为外部数据集。

在 所示的数据集设置窗口中选中数据集列表中的一个数据集，点击右边的【转为内建】按钮，即可把外部数据集转为内建数据集。如下图所示：

  

从上图中我们看到ds1转为内建数据集后，右边的【转为内建】按钮变成了【还原】按钮。选中数据集列表中的ds1，点击【还原】按钮，ds1内建数据集就还原成了它最初的“SQL检索”数据集类型。如下图所示：

  

	注意
	把内建数据集还原为外部数据集，要求内建数据集最初是由外部数据集转化而来的，不能是用户自己建的内建数据集，如果是用户自己建的内建数据集不能还原为外部数据集合。

在中点击【增加】按钮，弹出数据集类型对话框。

选择“自定义”数据集类型，点击【确定】按钮，弹出“自定义数据集”窗口，如下图所示：  

在数据集类名编辑框中输入数据集类名，该类应该由程序员自己实现，实现润乾报表提供的一个接口IDataSetFactory，

IDataSetFactory接口只定义了一个方法： public DataSet createDataSet(Context ctx, DataSetConfig dsc,boolean retrieve)

自定义类必须实现此方法，并返回一个DataSet对象，以下是对本方法的说明：

功能：生成自定义数据集 public DataSet createDataSet(Context ctx,DataSetConfig dsc, boolean retrieve) Parameters: ctx  报表运行上下文 dsc - 数据集配置 retrieve - 是否检索出数据，若为false则不取出数据只产生数据集的结构 createDataSet()方法由系统调用，我们不用去关心怎么调用它，而关心的是如何利用已有的方法参数，根据需要实现这个方法。createDataSet()方法返回的是一个DataSet对象，可以开始时便新建一个用于返回的DataSet对象： int rows = listsize(); //数据初始行数,根据实际求得 int cols = 3; //数据列数 DataSet ds = new DataSet(rows,cols,"ds1"); DataSet的三个参数分别是数据初始行数、数据字段列、数据集名。新建DataSet对象后往其中设置数据字段名，这个过程一定要在设置数据前。例如，我们要对这个数据集添加三个数据字段： ds.addCol( "name" ); //列名 ds.addCol( "subject" ); //列名 ds.addCol( "grade" ); //列名 对于有字段的数据集，就可以设置其包含的数据了： for( int i = 0; i < rows; i++ ) { Row row = ds.addRow(); DataBean data = (DataBean) list.get(i); row.setData(1, data.getName()); row.setData(2, data.getSubject()); row.setData(3, new Integer(data.getGrade()) ); }

点击【增加】按钮，为自定义数据集添加参数。

点击【确定】按钮，一个自定义数据集就建好了。