jasper-reports - 如何在 Jaspersoft Studio 中传递数组/集合类型的参数并在查询时使用它？

Question

我正在尝试使用“IN”子句将一组值作为参数传递，以从我的 DW 获取报告。

问题是，当我将参数设置为“Array”或“Collection”时，它不会在 Jaspersoft Studio Preview 屏幕上提示，我无法使用它。

第一次，我尝试将参数作为字符串传递，其中 $P{convenio} 是一个字符串，传递给完整的“IN”:

//Select and joins here...
WHERE ("o"."status_operacao" IN ('EFETUADO', 'SUSPENSO'))
  AND ("c"."codigo" IN ( $P{convenio}))
  AND ("o"."codigo_produto" = 1)

没有成功，返回错误“missing EOF at ')'”，但是没有关闭错误。

最后一个选项是使用 $X{}，所以我将 de $P{convenio} 设置为数组/集合类型，并像这样转换查询:

//Select and joins here...
WHERE ("o"."status_operacao" IN ('EFETUADO', 'SUSPENSO'))
  AND ($X{IN, "c"."codigo", convenio})
  AND ("o"."codigo_produto" = 1)

但现在参数没有提示，报告给我带来了一切。

Answer 1

JasperReports 引擎支持嵌套类型 - 我们可以使用类型化集合。

在 JSS 中显示集合 - 使用对话框设置值

例如我们可以这样声明Collection类型的参数:

<parameter name="collectionParam" class="java.util.Collection" nestedType="java.lang.Long"/>

带有类型集合的报告的小例子:

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="Blank_A4_2" pageWidth="595" pageHeight="842" whenNoDataType="AllSectionsNoDetail" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">
    <property name="com.jaspersoft.studio.data.defaultdataadapter" value="One Empty Record"/>
    <parameter name="collectionParam" class="java.util.Collection" nestedType="java.lang.Long"/>
    <title>
        <band height="30" splitType="Stretch">
            <textField>
                <reportElement x="0" y="0" width="550" height="30"/>
                <textFieldExpression><![CDATA[$P{collectionParam} != null && !$P{collectionParam}.isEmpty() ? $P{collectionParam}.toArray()[0] : "empty"]]></textFieldExpression>
            </textField>
        </band>
    </title>
</jasperReport>

我们可以像这样在 Jaspersoft Studio (JSS) 中初始化集合:

第一步 - 调用参数对话框:

第二步 - 添加元素到集合:

我们可以通过预览操作检查(构建)报告:

- 结果我们在表达式的帮助下显示了 Collection 的第一个元素:

<textFieldExpression><![CDATA[$P{collectionParam} != null && !$P{collectionParam}.isEmpty() ? $P{collectionParam}.toArray()[0] : "empty"]]></textFieldExpression>

使用默认值表达式初始化Collection类型的参数

我们可以在 defaultValueExpression 的帮助下初始化 Collection 类型的参数，例如 java.util.Arrays.asList() 方法:

<parameter name="collectionParam" class="java.util.Collection">
    <defaultValueExpression><![CDATA[java.util.Arrays.asList("a", "b", "c")]]></defaultValueExpression>
</parameter>

在查询时使用

在$X{IN, <column_name>, <parameter_name>}的帮助下，可以在查询时使用Collection类型的参数表达。

例子:

<parameter name="param" class="java.util.Collection">
    <defaultValueExpression><![CDATA[java.util.Arrays.asList("val")]]></defaultValueExpression>
</parameter>
<queryString>
    <![CDATA[SELECT * FROM table_name c WHERE $X{IN, c.attr, param}
</queryString>

此表达式将在运行时由 JasperReports 引擎转换为如下查询:

SELECT * FROM table_name c WHERE c.attr IN ('val')

我们还可以在查询时使用String 类型的参数，并使用$P!{} 结合IN 运算符|表达。

例子:

<parameter name="param" class="java.lang.String">
    <defaultValueExpression><![CDATA["'val1', 'val2'"]]></defaultValueExpression>
</parameter>
<queryString>
    <![CDATA[SELECT * FROM table_name c WHERE c.attr2 IN ($P!{param})
</queryString>

此表达式将在运行时由 JasperReports 引擎转换为如下查询:

SELECT * FROM table_name c WHERE c.attr2 IN ('val1', 'val2')