iReport預設參數和變量的含義解析【轉】

變量：

$V{PAGE_NUMBER}代表目前頁數（可以是頁碼也可以是頁數，通過TextField的計算時間的不同值來設定）

$V{PAGE_COUNT} 目前頁面中記錄的數目

$V{groupname_COUNT}代表目前組的記錄數 eg:如果組是根據$F{the_city}分組，組名是CityGroup的話，那麼此變量為$V{CityGroup_COUNT}

$V{COLUMN_NUMBER} 列号碼

$V{COLUMN_COUNT} 目前列中記錄的數目（是目前頁裡行的序号，在新頁上會重置為1）

$V{REPORT_COUNT} 目前文檔中資料源記錄數目

對于$V{PAGE_NUMBER}:

當evaluationTime="Now"時,即是計算當頁所在哪一頁. (now:即時執行此表達式.)

當evaluationTime="Report"時,即是計算當頁所在哪一頁.(Report:整個報表執行完後才執行此表達式)

2.參數：

Parameter name Class type

$P{REPORT_PARAMETERS_MAP} java.util.Map

這是一個内置的參數，這個參數總是指向一個 java.util.Map 對象，該對象儲存了使用者調用報表裝填過程時傳遞給報表引擎的使用者定的參數。

$P{REPORT_CONNECTION} java.sql.Connection

這個報表參數指向一個 java.sql.Connection 對象，這個對象被提供給報表引擎用來通過 JDBC 來執行 SQL 報表查詢。将 master 報表使用的 JDBC Connection 對象傳遞給 subreport 是非常有用的，有關這方面資訊請檢視 subreport 例子

$P{REPORT_DATA_SOURCE} net.sf.jasperreports.engine.JRDataSource

在報表裝填的時候，我們可以或者直接由應用程式中提供，或由報表引擎從所提供的 JDBC 　 Connection 在背景 create 而獲得一個資料源。這個内置的參數允許我們在報表表達式中或 scriptlet 中通路報表資料源，而不論我們為什麼要這麼做。

$P{REPORT_SCRIPTLET} net.sf.jasperreports.engine.JRAbstractScriptlet

即使報表不使用 scriptlet ，這個内置的參數仍将指向一個 net.sf.jasper.engine.JRAbstracStriptlet 執行個體，該執行個體實際是一個 net.sf.jasper.engine.JRDefaultScriptlet 對象。

但是當使用 scriptlet 時，報表裝填過程所生成的這個指向 scriptlet 類執行個體的引用允許我們調用其中的某些特殊函數，使用或控制 scriptlet 對象在裝填過程中已經準備好的資料。在 scriptlet 例子中你可以看到更詳細的使用過程。

Built-in variables内置變量

PAGE_NUMBER 包含了目前頁碼，在整個報表中包含總的頁數。

COLUMN_NUMBER 包含目前是第幾列

REPORT_COUNT 訓示目前正在處理的是第幾條記錄

PAGE_COUNT 目前頁中包含了幾條記錄

COLUMN_COUNT 目前列中包含了幾條記錄

<group name>_COUNT 以變量字首來表示這個組記錄數

Evaluation Time指派時間

Now 立即求表達式的值

Report 報表産生之後求表達式的值

Page 頁未求表達式的值

Colum n列末求表達式的值

Group求每組的值

例如：

第幾頁：$V{PAGE_NUMBER} Evaluation Time ：Now

總頁數：$V{PAGE_NUMBER} Evaluation Time ：Report

Calculation types計算類型

Nothing 不是計算類型，它被使用當使用者指定内在的表達式時，每條記錄将被指派。

Count 計算所有非null的表達式的次數，不要把它和sum搞混了，sum是計算的是數字的結果

Sum 反複的疊加表達式目前的值

Average 計算所有标準輸入的表達式的平均值。

Lowest 傳回标準輸入中最低的表達式的值

Highest 傳回标準輸入中最高的表達式的值

StandardDeviation 傳回标準輸入中規格不同的表達式值standard deviation

Variance 傳回标準輸入中不一緻的表達式值

System 不是一種計算方式，也不求表達式的值；使用這個後，報表引擎僅将最後一個變量值放入記憶體中；它可以用腳本來存儲計算結果。.

Reset types重置類型

None 這個Initial Value Expression總是被忽視

Report 這個變量被初始化一次僅僅在報表建立的開始，用Initial Value Expression。

Page 這個變量被初始化在每個新頁

Column The這個變量被初始化在每個新列（或者在每頁，如果這個報表頁僅僅隻有一列的話）

Group The 這個變量被初始化在每一個新的組（我們定義這個組用Reset Group)

3.網上資料：

寫道

(1)

JasperReports是一個開源的java報表制作引擎

iReport是JasperReports的一個GUI工具，用來生成JasperReports的jrxml檔案。

JasperReports的報表是用XML檔案來定義的，約定用jrxml作字尾名。一個典型的jrxml檔案包含以下元素：

* <jasperReport> - 根元素

* <title> - 報表的标題，一篇報表裡隻在開頭列印一次

* <pageHeader> - 頁眉，報表每頁開頭列印一次

* <detail> - 報表正文

* <pageFooter> - 頁腳，報表每頁末尾列印一次

* <band> - 定義報表部件，以上所有元素都包含一個band元素作為他們唯一的子元素

·Summary：可能需要對幾頁（你的報表可能有幾個頁組成）的統計值。比如50個銷售記錄共占用了3頁，那麼放置這些統計記錄的統計值最好的地方就是summary。

·groupHeader：每個表的内容可能需要根據某個屬性進行劃分顯示内容和計算内容，比如希望以月份為機關每組分開顯示銷售記錄，那麼就可以定義一個組（組的定義參考後文），groupHeader就是放置組說明或是組标志最好的地方。

·Groupfooter：放置組的統計或是說明

(2)

各元素分析:

static text:靜态文本,隻是用來在報表中顯示;

$P--->表示是參數;

如:"20"+$P{statement_current_date}

$F--->表示是textfield變量.

如:$F{account_code}

此變量是在<field name>中定義的.其值是在<queryString>中,通過select資料庫後,得到的.

select的列名 = field name

$V--->表示一個變量

如:$V{balance}

變量的預設值是在報表中設定的.一般設定為0.其真正的值是通過 $P或$F來獲得的.

(3)

A,報表中的QueryString語句,可以通過界面上的DataBase中的Report SQL Query來進行添加-->會自動生成相應的TextField.若不行,則可自動手動添加.

B,如果要直接修改代碼,可以選擇界面上的'編輯'-->'直接編輯XML Source'-->先進行儲存-->就會出現代碼界面.

C,如果要修改JASPER REPORT的屬性,可以選擇界面上的'預覽'-->'報表屬性'

E,添加group,可以通過點選界面上的相應'group'按鈕來添加.

F,隐藏不要的區域,要設bank=0,而不能删除為空.删除為空,則為預設值

G,IReport中的左欄中的各元素的後面的[X,Y]内的資料,是指此元素偏離'左上角'的X,Y距離.

H,設定子報表時,要将子報表的屬性中的"上邊界,下邊界,左邊界,右邊界"全部設定為0,否則會出現子報表傳回來的資料,在主報表中沒法對齊的現象.

(4)

當沒有資料(是指QueryString語句SELECT出來的資料為NULL)時,設定怎樣顯示:

相關代碼:

whenNoDataType="NoPages / BlankPage / AllSectionsNoDetail"

NoPages:當沒資料時,會彈出一個對話框提示你沒資料,然後顯示一個沒激活的框.

BlankPage :不會提示,隻是顯示一個白紙.

AllSectionsNoDetail:不會提示,但那些靜态的文本,以及從上一層或JAVA檔案中傳來顯示的參數,都可以顯示.

(5)

内置的報表變量:

$V{PAGE_NUMBER}:(常用)

這個變量儲存目前的頁号，在報表裝填結束的時候，這個變量就儲存着最終文檔的總頁數。是以要在JasperReport的文本字段中顯示頁号和總頁數你都可以用它。

隻需要添加一個系統的變量:$V{PAGE_NUMBER};

對于$V{PAGE_NUMBER}:當evaluationTime="Now"時,即是計算當頁所在哪一頁. (now:即時執行此表達式.)

并将其轉換為String的類型.

C,總體代碼:

"Page " + String.valueOf($V{PAGE_NUMBER}) + " Of"

</textFieldExpression>

</textField>

String.valueOf($V{PAGE_NUMBER})

$V{REPORT_COUNT}:

當evaluationTime=Report時,将記錄報表的總記錄數.

當evaluationTime=Column時,将記錄報表從開始到目前頁的總記錄數.

Variable COLUMN_NUMBER

這個變量将記錄目前的列号。

Variable PAGE_COUNT

這個變量紀錄目前頁中處理的record的數目。

Variable COLUMN_COUNT

這個變量紀錄生成目前列時所處理的record的數目。

(6)

field的動态顯示+動态顯示不同的格式:

有些報表可能需要對同種類型的資料根據重要性不同而顯示不同的風格。例如，要在訂單清單中加亮顯示金額超過100$的訂單.

而文本域的現實格式不能動态改變，我們如何實作這種功能呢？

解決辦法是：

在同樣的位置放兩個文本域來顯示相同的内容，但是設定不同的顯示格式，一個正常顯示，一個加粗并加亮顯示紅色，同時還要為他們設定<printWhenExpression>元素，讓他們可以根據條件表達式來切換。這裡的表達式就是$F{value} < 100（正常顯示的文本域）和$F{value} >= 100（加亮顯示的文本域）。

(7)

建立子報表

在代碼中,将子報表以參數形式加載:

JasperReport sixUnitPrice = (JasperReport)JRLoader.loadObject("jasper/TrendAve_ItemIntel_6MonthUnitPrice.jasper");

parameters.put("sixUnitPrice", sixUnitPrice);

在主報表中,建立上面的相應參數sixUnitPrice. 其類型為:net.sf.jasperreports.engine.JasperReport

在iReprot中添加,劃拉出一塊子報表.

在subReport項中,選中:' use connection expression '

在subReport other項中:

設定image expression class=net.sf.jasperreports.engine.JasperReport

設定subreport expression中填寫代碼中的相應參數:$P{sixUnitPrice}

設定要傳到子報表的參數,并在主報表中建立相應的參數.

建立子報表,建立一參數(與主報表傳遞的參數一樣),來接收從主報表傳來的參數.-->即可應用了.

說明:

位于多層之下的子報表,也需要從主報表開始時,就可以加載,傳遞下去,否則加載不了.因為一開始,都是從JAVA檔案中從傳過來,然後一層層傳下去的.

(8)

hashmap參數在報表間傳遞值的用法

如何帶參數:

在某層子報表中建立一個新的子報表,此新子報表,必須從:報表java類中定義-->主報表-->各上級父報表中對此新子報表進行定義(定義此參數+各父報表添加此新報表參數,以便其子報表可以獲得)-->目的子報表

2)hashmap參數在報表間傳遞值的用法

如上的專題記錄,$P{group_total_hash}此參數是一個hashmap,從其定義是在子報表中的,最終用:是在主報表中,作為統計資料.

怎樣用:

先在主報表,以及子報表中都要定義hashmap,并在子報表的各上層報表進行指派,使參數可以主報表與子報表中間進行傳遞:

</parameter>

在子報表中,在區間的顯示屬性中添加:

$P{group_total_hash}.put();如下:

$P{trayout_hash}.put("trayout",$F{totalqty}) == null?

Boolean.TRUE:Boolean.TRUE

在主報表中:

子報表的傳回值有一個問題：它們是在目前區域的所有元素都被處理之後才傳回的。

是以，為了能在主報表中的子報表所在的同一區域顯示傳回值，我們必須延遲文本域表達式的處理時機。這是通過加入一個無效的分組讓表達式在分組結束時處理來實作的，而這個無效分組的效果就是資料源中的每條記錄就是一組，而且它自己沒有組頭群組尾區域。

添加一Field,設定資料類型為Double,且Evaluation time=Column(否則資料出不來)

$P{group_total_hash}.get();如下:

new Double

(

((Double)$P{trayout_hash}.get("trayout")).doubleValue()

((Double)$P{trayin_hash}.get("trayin")).doubleValue()

)

具體可以參考ACCOUNT中的PL報表,或SCM中的item intelligence報表中的設定及用法:

主報表:

ProfitLoss_basic.jrxml

用于計算各部分total的子報表:

ProfitLoss_basic_subReport_profit_loss_total_year_list.jrxml

或

TrendAve_ItemIntelReport.jrxml

TrendAve_ItemIntel_trayout.jrxml.

(9)

Group的用法:

用法一:(分類顯示及計算)

假設有兩表:

mysql> select * from A;

+------+------+

| id | name |

| 1 | hk |

| 2 | hk |

mysql> select * from B;

+------+------+------+-------+

| id | Aid | name | value |

| 1 | 1 | sz | 1 |

| 1 | 1 | cz | 1 |

| 2 | 2 | zh | 1 |

| 2 | 2 | gz | 1 |

報表要分兩層,第一層循環查詢A表,第二層(即子報表)循環查詢B表在屬于A表的記錄.

若不用group,則會出現(-->後面是各元件中iReport中的位置):

ID Name value -->放于報表中的pageHeader

1 hk 1 -->放于第一層報表中的detail -->循環每一條記錄且顯示

1 sz 1 -->放于第二層報表中的detail

2 cz 1

2 hk 1 //name與上相同

1 zh 1

2 gz 1

若采用group按照name進行分組,則jasper會把name相同的放入一組,隻顯示一次.

采用name分組後的效果:

1 hk 1 -->放于第一層報表中groupHeader,将所有相同的name集合在一起,隻顯示一次

sum value: 5 -->放于第一層報表中groupFooter

補充說明:

對于上面的group,須先點選"group"按鈕進行定義(如:nameGroup).

同時,可以以group的基準進行計算(結合變量variable),放于groupFooter.

在iRport中,建立變量sumValue,定義如下:

variable type: Double

caculation type: sum

Reset type: Group

Reset Group: 上面自定義的group名(如:nameGroup)

variable expression:(即進行計算的表達式) $F{value}

在groupFooter添加一field:

須定義:

Evaluation time : group,而不是now

Evaluation Group: 上面自定義的group名(如:nameGroup)

jasper報表,子報表内容顯示重疊

在jasper中,若在detail區域中,把兩個一模一樣的子報表上下放置.則在循環輸出時,會出現上下子報表

輸出内容相遮掩的結果.

解決方案:用group分離顯示.

把兩個子報表,分别放于兩個不同的group中,分組條件為主報表的每一個ID,這樣,主報表循環顯示時,就

會将各分組一一顯示出來,不會影響其顯示.

用法二:

利用group來進行分組和實作子報表傳回值:

第(8)點的傳回值,隻适合于非循環性的.

若在主報表的detail區域,需要讓每條record都将子報表傳回值到對應的record中,則要采用這種方法.上面的方法實作不了.

因為子報表的傳回值有一個問題：它們是在目前區域的所有元素都被處理之後才傳回的。如果你想在子報表所在的主報表區域顯示它的傳回值，你最終将看到它們傳回的太晚了。

具體實作方法:

先在主報表,子報表建立一個同名的hashmap容器,且将主報表的這個參數作為子報表的傳遞參數,傳到

子報表中.

在報表中,對視窗進行加值:

方式一:

在子報表中，在summary區域的屬性中添加:

$P{trayout_hash}.put("trayout",$F{totalqty}) == null?Boolean.TRUE:Boolean.TRUE

方式二:

在子報表中，在summary區域中添加一個不可見的直線元素,且在其中設定:

<line>

$P{trayout_hash}.put("trayout",$F{totalqty}) == null?Boolean.FALSE:Boolean.FALSE

</printWhenExpression>

</reportElement>

</line>

在主報表中,添加一個分組,以每條記錄作為一個分組.操作如下:

A,點選GROUP按鈕.

B,填寫組名;

C,分組表達式: $F{item_code}.(也可以id作為分組) -->分組的關鍵所在

D,選擇:是否start on a new page -->讓最後所得的分組,是否以分頁的形式顯示.

對于detail區域中,要傳回值的field,這樣設定:

$P{trayout_hash}.get("trayout")

采用Group實作傳回值的說明:

子報表的傳回值有一個問題：它們是在目前區域的所有元素都被處理之後才傳回的。如果你想在子報

表所在的主報表區域顯示它的傳回值，你最終将看到它們傳回的太晚了。

是以，為了能在主報表中的子報表所在的同一區域顯示傳回值，我們必須延遲文本域表達式的處理時

機。這是通過加入一個無效的分組讓表達式在分組結束時處理來實作的，而這個無效分組的效果就是

資料源中的每條記錄就是一組，而且它自己沒有組頭群組尾區域。

</group>

(10)

若資料類型設定為Double,則須:

$P{trayout_hash}.get("trayout")-->Object類型;

((Double)$P{trayout_hash}.get("trayout"))-->轉換成Double類型;

((Double)$P{trayout_hash}.get("trayout")).doubleValue()-->轉換成double類型,進行計算;

new Doubel(A-B)--->将最終結果轉換成Double,因為上面設定類型類型時,用了Double.

如下:

(11)

變量還可以聲明來完成引擎内建計算的求值，如：count、sum、average、lowest、highest、 variance等等。一個完成Quantity字段sum計算的變量定義如下：

<variable name="QuantitySum"

class="java.lang.Double" calculation="Sum">

<variableExpression>$F{Quantity}</variableExpression>

</variable>

我們還可以通過制定初始化級别來改變計算過程，預設的級别是Report就是變量僅在報表開始處初始化一次，一直到報表結束完成計算。

我們可以選擇更低的級别讓變量在每個Page、Column或者Group級别重新初始化。假如我們想計算計算每頁的總數，變量聲明如下：

<variable name="QuantitySum" class="java.lang.Double"

resetType="Page" calculation="Sum">

<initialValueExpression>new Double(0) </initialValueExpression>

變量将在每一頁的開始處被初始化為0。

(12)

變量的resetType解釋:

報表變量的值可以在每一次疊代（iteration）中被改變，但也可以在裝填過程中的某一特定的時間（specified moments）通過它的初始的value表達式恢複其初始值。這一行為是由resetType屬性控制的，這一屬性規定了報表裝填過程中當報表變量在何時需要重新進行初始化（或恢複到初始值）。該元素有五種選項值：

4.1

No Reset：變量将不會使用其initial value expression對自身進行初始化，而将僅報表從變量表達式中所求得的值（resetType=”None”）。

4.2

Report Level Reset：變量将在報表填充過程的起始階段使用其初始化表達式初始化一次（resetType=”Report”）。

預設的屬性為resetType=”Report”

4.3

Page Level Reset：變量将在每一頁的起始時被重新初始化（resetType=”Page”）。

4.4

Colunm Level Reset：變量将在每個新列的開始被初始化（resetType=”Column”）

4.5

Group Level Reset:變量将在每次resetGroup屬性提供的break的地方被重新初始化（resetType=”Group”）。

Reset Group

如果存在的話，resetGroup屬性包含了報表的組的名字并且僅與resetType=”Gropu”的resetType屬性相關聯。

(13)

報表的分層顯示方法:

外層,在主報表中查詢循環顯示;

下層,在子報表中查詢循環顯示.

iReport預設參數和變量的含義解析【轉】

繼續閱讀

Java String.format方法的簡單使用

neo4j之cypher使用文檔

GitHub連夜封殺！這份阿裡 10W 字内部 Java 字面試手冊到底有多強？

spark/scala關于【資源檔案】加載方法概述外部檔案加載方案測試資源檔案打包入jar包中小結

NOSQL安全攻擊

mybatis_入門程式Mybatis入門

AOP程式設計_Android優雅權限架構(1)概念基礎，2021金三銀四前言正文大綱正文

登入plsql 報錯 the account is locked --使用者被鎖

sqlServer根據經緯查距離

Effective Java 8:通用程式設計

SequoiaDB巨杉資料庫C++驅動概述

OOM三種類型

工廠模式-三種類型

【遞歸】高效率求2的n次幂

win10本地scala和spark安裝安裝scala安裝spark

scala (3) Function 和 Method