06-Birt工具关于使用外部数据源的配置手册

关于使用外部数据源的报表的配置问题
--2010-8-27
根据前期报表的设计讨论，使用外部数据源的情景如下：
用户配置了一个报表，主SQL已经确定，即需要查询的数据集已经确定，但是参数的数据来源在后期需要重新变化，如ad-hoc生成的临时表。

为了不用再去重新设计一张报表，特别设计了该功能。

由于时间仓促，有些地方没有考虑全面，需要在脚本中进行一些调整，还请见谅。

外部数据源报表的配置如下：
1、配置一张报表，数据集主SQL如下：
图1
当然，也可以添加一些其他条件。

2、设计报表参数
图2
对于报表参数，暂时只对字符串类型的参数进行了处理，所以，请使用字符串数据类型。

3、数据库配置
图3
数据库配置时，请注意图3画红色框框的地方。

表：t_birt_table_sql
字段：QRY_ID 报表名称
字段：QRY_FILED_NAME 即图2中参数名称
字段：QRY_SQL 参数的数据来源，如果只提供一个字段，数据显示的名称和数据值将显示一样。

字段：STAFF_ID 员工编号，即用户登录系统后，系统使用的员工编号
4、修改脚本
在数据集的beforeOpen脚本中添加如下脚本代码
//获取参数信息
var userIds=params["user_id"].value;
var querySQL=this.queryText
var whereClause=" 1=1 ";
//判断参数是否为空或者没有数据输入
if(userIds!=null&&userIds!='')
{
//拼SQL
whereClause += " and user_id in ('";
//如果是外部数据源数据，一般会获得一个如下格式的字符串
//[a,b,c]或[a]或[]
//将其按照逗号拆分
var userIdArray=userIds.split(",");
//如果拆分的结果为空或者没有数据，跳出
if(null != userIdArray && userIdArray.length > 0)
{
//将拆分的结果拼接起来，这里利用了js的一些自带函数
//拆分结果格式 "[a","b","c]"
//预期拼接结果"[a','b','c]"
var str = userIdArray.join("','");
//去掉数组转换时的中括号
//如果首尾为一对中括号，一般是外部数据源
if("["== str.substring(0,1) && "]"== str.substr(str.length-1))
{
//掐头去尾
str = str.substring(q,str.length-1);
}
//补充完SQL
whereClause += str + "')"; }
else
{
whereClause += "')"
}
}
//拼接SQL
if(whereClause!=null&&whereClause!='')
{
this.queryText += " where "+ whereClause; }
5、测试...。