BIRT报表参数无法接收逗号分隔的多值MEDID问题

问题场景 #

前端传递的报表链接示例：

PharmacyItemDispnse_ByOffice.rptdesign&SDATE=2024-01-08&EDATE=2024-01-08&OID=7&MEDID=253078,253077,253076

MEDID参数在BIRT中设置为String类型，SQL查询使用IN语句接收该参数，但出现如下错误：

Error:
 Cannot convert the parameter value 253076,253077,253078 at index 1 from the value type of class java.lang.String to the ODA type of 4. For input string: "253076,253077,253078"

当前数据集的SQL查询语句：

SELECT  
    ite.ITEM_PDT_ID,    
    ite.ITEM_NAME , 
    im.ITEM_CODE ,  
    ite.item_unit, 
    inv.OFFICE_ID,  
    od.OFFICE_NAME, 
    sum(ite.item_qtysold) total_dispensed 
FROM
    ABC.invoice_item ite 
INNER JOIN ECLINIC_KNG.invoice inv 
    ON ite.item_invoice_id = inv.invoice_id 
LEFT JOIN ECLINIC_KNG.OFFICE_DETAILS od ON inv.OFFICE_ID = od.OFFICE_ID  
LEFT JOIN ECLINIC_KNG.ITEM_MASTER im ON ite.ITEM_PDT_ID = im.ITEM_ID 
WHERE   
    inv.INV_STATUS = 'Closed' AND 
    inv.INV_CANCEL_STATUS = 'N' AND
    inv.office_id = ? AND 
    inv.invoice_date BETWEEN ? AND ?
    AND ite.ITEM_PDT_ID IN (?)
GROUP BY 
    ite.ITEM_PDT_ID,
    ite.ITEM_NAME,
    im.ITEM_CODE,
    ite.item_unit,
    inv.OFFICE_ID,
    od.OFFICE_NAME

错误原因 #

BIRT的参数绑定机制会把逗号分隔的MEDID字符串当成单个参数值传递给IN语句，而数据库期望的是多个独立的数值（ITEM_PDT_ID为数值类型），因此触发类型转换错误。

解决方案 #

方案1：数据集脚本动态替换IN子句 #

在数据集的beforeOpen脚本中，将MEDID参数按逗号拆分后直接拼接进SQL语句：

// 拆分MEDID参数为数组
var medIdArray = params["MEDID"].split(",");
// 替换SQL中的(?)为拆分后的参数列表（ITEM_PDT_ID是数值类型，无需加单引号）
this.queryText = this.queryText.replace("(?)", "(" + medIdArray.join(",") + ")");

若ITEM_PDT_ID是字符串类型，需给每个ID添加单引号，修改为：

this.queryText = this.queryText.replace("(?)", "('" + medIdArray.join("','") + "')");

方案2：使用多值参数（需前端配合） #

1. 在BIRT报表中，将MEDID参数设置为多值参数（类型保持String）；
2. 前端传递参数时改为多值格式：MEDID=253078&MEDID=253077&MEDID=253076；
3. 此时SQL中的IN (?)会被BIRT自动处理为IN (?, ?, ?)，自动绑定多个参数值，无需额外脚本。

方案3：数据库字符串拆分函数（注意性能） #

如果无法修改前端或报表参数配置，可利用数据库内置的字符串拆分函数，比如：

• MySQL：用FIND_IN_SET(ite.ITEM_PDT_ID, ?)替代IN (?)
• Oracle：用REGEXP_SUBSTR拆分字符串后匹配
• SQL Server：用STRING_SPLIT(?, ',')配合IN子句

这种方式无需修改报表参数，但数据量大时可能导致索引失效，影响查询性能。

内容的提问来源于stack exchange，提问作者Luke