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

Question

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

问题是，当我将参数设置为“Array”或“Collection”时，Jaspersoft Studio预览屏幕上没有提示，并且我无法使用它。

第一次，我尝试将参数作为字符串传递，其中 $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 )中初始化集合，如下所示：

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

第二步 - 将元素添加到集合中：

我们可以通过预览操作检查（构建）报告：

- 因此，我们在表达式的帮助下显示集合的第一个元素：

<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>

使用 at 查询

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

例子：

<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类型的参数以及使用表达式的IN$P!{}运算符。

例子：

<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')