如何在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)

它不起作用，返回错误“在'）'缺少EOF”，但是没有关闭错误。

最后一个选项是使用$ 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 ：

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

-结果是我们借助表达式显示了 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>

在查询中使用

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 类型的参数，并结合使用$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')