如何在 Jaspersoft Studio 中传递 array/collection 类型的参数并在查询时使用它？

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} 设置为 Array/Collection 类型，并像这样转换查询：

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

在查询时使用

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

如何在 Jaspersoft Studio 中传递 array/collection 类型的参数并在查询时使用它？

How to pass a parameter of array/collection type at Jaspersoft Studio and use it at query?

jasper-reports

jaspersoft-studio

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

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

在查询时使用