【文章內(nèi)容簡(jiǎn)介】 各自在報(bào)表模板文件中所代表的意思： 表頭：整個(gè)報(bào)表的開始部分（或叫區(qū)域，下同）。 表尾：整個(gè)報(bào)表的結(jié)束部分。 頁頭：每個(gè)分頁的開始部分。 頁尾：每個(gè)分頁的結(jié)尾部分。 組頭：每個(gè)數(shù)據(jù)分組的開始部分。（什么是組？） 組數(shù)據(jù)區(qū)：每個(gè)組數(shù)據(jù)輸出部分。 組尾：每個(gè)數(shù)據(jù)分組的結(jié)尾部分。 band數(shù)據(jù)區(qū)頭：每個(gè)band數(shù)據(jù)區(qū)開始部分。（什么是band？）band數(shù)據(jù)區(qū)：每個(gè)band數(shù)據(jù)區(qū)數(shù)據(jù)輸出部分。 band數(shù)據(jù)區(qū)尾：每個(gè)band數(shù)據(jù)區(qū)結(jié)束部分。在上述報(bào)表的基本元素中，組和band是兩個(gè)比較特殊，也非常常用的元素。由于他們本身比較靈活，因此你需要在你的報(bào)表設(shè)計(jì)過程當(dāng)中需小心謹(jǐn)慎地使用它們，通過一些巧妙的模板定義你也可以構(gòu)建出一些特殊效果的報(bào)表。當(dāng)然不同的報(bào)表工具可能對(duì)這些概念的命名和具體規(guī)定的細(xì)則不定相同，但其基本的原理還是一致的。接下來的一節(jié)我們會(huì)詳細(xì)介紹應(yīng)該如何將這樣一些基本的報(bào)表元素放在一個(gè)Excel Report報(bào)表模板中去。 報(bào)表模板中的基本元素 在本章的開頭部分我們大致了解了在制作一個(gè)報(bào)表的過程當(dāng)中，可能會(huì)使用到的一些基本的概念，接下來的這一節(jié)我們會(huì)詳細(xì)介紹這些基本元素應(yīng)該如何應(yīng)用到我們的Excel Report模板文件中去。 下面我們列出一個(gè)表格，該表格詳細(xì)說明了Excel Report中所用到的所有模板配置過程當(dāng)中用到的基本報(bào)表元素： 基本元素Excel Report對(duì)應(yīng)定義規(guī)則詳細(xì)說明表頭任何band或組定義的開始之前的區(qū)域在Excel Report工具中考慮到模板設(shè)置的簡(jiǎn)化，因此沒有去設(shè)定專門定義表頭開始區(qū)域的模板定義元素，而是將所有band或組定義之前的所有區(qū)域都自動(dòng)認(rèn)為是報(bào)表的表頭部分。表尾任何band或組定義結(jié)束之后的區(qū)域同上頁頭無通過excel自己的分頁功能來實(shí)現(xiàn)頁尾無通過excel自己的分頁功能來實(shí)現(xiàn)組頭$G{ property=head }定義行－$G{ property=body }定義行之間的區(qū)域在Excel Report工具中定義一個(gè)組都是通過設(shè)定$G{開頭，并以}結(jié)尾的單元格來標(biāo)識(shí)一個(gè)組模板定義信息。組模板定義有幾個(gè)屬性值必須指定：Name：標(biāo)識(shí)當(dāng)前組名稱Property：標(biāo)識(shí)當(dāng)前組定義區(qū)域，有四個(gè)可選值（head組頭，body組數(shù)據(jù)區(qū)，foot組結(jié)尾，end組定義結(jié)束 注：該屬性值是有順序的，模板的定義必須是headbodyfootend否則系統(tǒng)會(huì)仍出無效的模板定義的異常信息出來）dataSource：定義當(dāng)前分組的數(shù)據(jù)源。組數(shù)據(jù)區(qū)$G{property=body }到$G{property= foot}之間的區(qū)域同上組尾$G{property=foot}到$G{property=end}之間的區(qū)域同上band頭$B{property=head}到$B{property=body}定義行之間的區(qū)域類似于分組定義，聲明一個(gè)band通過設(shè)定$B{開頭，并以}結(jié)尾的單元格來標(biāo)識(shí)一個(gè)band模板定義信息。Band的模板定義同樣也有幾個(gè)屬性值必須指定：Name：標(biāo)識(shí)當(dāng)前band名稱Property：標(biāo)識(shí)當(dāng)前band定義區(qū)域，有四個(gè)可選值（headband頭，bodyband數(shù)據(jù)區(qū)，footband結(jié)尾，endband數(shù)據(jù)區(qū)定義結(jié)束。注：該屬性值是有順序的，模板的定義必須是以headbodyfootend的順序來定義，否則系統(tǒng)解析模板時(shí)會(huì)拋出無效的模板定義的異常）dataSource：定義當(dāng)前band對(duì)應(yīng)的數(shù)據(jù)源band數(shù)據(jù)區(qū)$B{property=body}到$B{property=foot}之間的區(qū)域同上band尾$B{property=foot}到$B{property=end}之間的區(qū)域同上其它Excel Report模板定義元素：Excel Report模板元素說明$P{parameterName}參數(shù)變量模板元素該語法用來定義一個(gè)參數(shù)變量模板元素。一個(gè)參數(shù)變量模板元素，表示當(dāng)前模板定義所在的單元格的內(nèi)容在生成報(bào)表過程中，報(bào)表生成工具會(huì)取參數(shù)變量模板元素定義的參數(shù)值來替代。（參數(shù)名稱：由parameterName指定）$F{}字段變量模板元素該語法用來定義一個(gè)字段變量模板元素。字段變量模板元素表示：該模板的實(shí)際值是根據(jù)運(yùn)行期數(shù)據(jù)源（datasourceName指定引用的數(shù)據(jù)源）中的實(shí)際字段（fieldName指定數(shù)據(jù)源中的字段名稱）值。報(bào)表工具在實(shí)際生成報(bào)表過程當(dāng)中，會(huì)在字段變量模板位置的單元格寫入該數(shù)據(jù)源實(shí)例對(duì)象對(duì)應(yīng)字段的實(shí)際值。$V{varibleName}變量模板元素該語法有兩層含義，用于不用的地方。1． 用來在報(bào)表中使用Excel原生的函數(shù)。我們可以通過$V{Excel Function(..)}的形式來聲明一個(gè)模板元素，該元素在生成報(bào)表時(shí)會(huì)輸出用戶配置的Excel 函數(shù)。()2． 用來引用另外一個(gè)變量。$S{}用來定義在模板對(duì)應(yīng)位置輸出一個(gè)字符串,在該模板變量里面可以嵌入其它模板元素如( $F{}, $P{}, $V{} ) 比如:定義$S{Hello: $F{}} 假設(shè)$F{}當(dāng)前值為39。excelReport39。 : 該模板運(yùn)行后的輸出效果: Hello: excelReport$R{}注意：在使用$V{}模板元素時(shí)，當(dāng)該元素應(yīng)用或使用其他字段值或變量，必須要求該變量在定義該模板元素之前就已經(jīng)存在。否則系統(tǒng)會(huì)無法引用該變量。（就是要注意順序問題，在引用一個(gè)變量的值時(shí)，該變量必須已經(jīng)定義/存在。） Excel Report模板文件的構(gòu)成在上面一節(jié)我們了解了在一個(gè)報(bào)表模板文件中可能會(huì)用到的模板元素，接下來我們從整個(gè)報(bào)表模板文件的整體布局來介紹，那些部分該放那些模板元素，應(yīng)該放什么樣的模板元素。這些問題都會(huì)在我們這一小節(jié)一一講解。然而由于不同風(fēng)格的報(bào)表其模板配置的布局也不盡相同，因此在下面的介紹中我們通過不同的報(bào)表的類型來分別介紹。1． 卡片式報(bào)表在目前系統(tǒng)提供的卡片式報(bào)表中，整個(gè)報(bào)表就一個(gè)區(qū)（卡片內(nèi)容區(qū)域），你可以認(rèn)為它沒有什么表頭，表尾的概念，因?yàn)樗麄€(gè)報(bào)表就一張靜態(tài)的卡片，在這個(gè)卡片區(qū)域內(nèi)我們可以放入：( $P{}, $F{}, $V{} )這樣一些模板元素。之所以定義卡片風(fēng)格的報(bào)表，是因?yàn)樵擃愋偷膱?bào)表要比列表式報(bào)表生成的速度更快，因?yàn)樗０宥x和解析都非常簡(jiǎn)單。（需要注意的是，在卡片式風(fēng)格的報(bào)表中不能定義$B{}或$G{}這樣的模板配置元素，因?yàn)樵擃愶L(fēng)格的報(bào)表在模板分析時(shí)會(huì)忽略該信息）2． 列表式風(fēng)格報(bào)表列表式風(fēng)格的報(bào)表是我們平常應(yīng)用最多的一種類型的報(bào)表，在該類報(bào)表的模板配置文件中一般可以由以下幾個(gè)區(qū)域組成：表頭區(qū)，表尾區(qū)，表數(shù)據(jù)區(qū)，band數(shù)據(jù)區(qū)，組數(shù)據(jù)區(qū)。整個(gè)報(bào)表模板文件分區(qū)： 整個(gè)模板文件可以分為三個(gè)大的區(qū)域：包含表頭區(qū)，報(bào)表數(shù)據(jù)區(qū)（band數(shù)據(jù)區(qū)，注意不能是組數(shù)據(jù)區(qū)），表結(jié)尾區(qū)。如下圖： 下面來詳細(xì)介紹每個(gè)區(qū)域的劃分規(guī)則和作用。表頭區(qū)：( 1所示區(qū)域)區(qū)域邊界定義：在任何一個(gè)$B{}模板元素定義前的那部分區(qū)域。 可用模板定義元素： $P{}, $F{}, $V{}區(qū)域輸出規(guī)則： 這部分區(qū)域在整個(gè)報(bào)表生成過程中都只輸出一次。且放在整個(gè)生成報(bào)表文件的最開始部分。報(bào)表數(shù)據(jù)區(qū)（band數(shù)據(jù)區(qū)）：( 2所示區(qū)域)區(qū)域邊界定義：在模板文件第一個(gè)出現(xiàn)$B{}模板定義元素的位置作為開始行，到最后一個(gè)$B{}模板定義元素的位置作為結(jié)束行，在開始和結(jié)束行之間的這段區(qū)域都作為報(bào)表數(shù)據(jù)區(qū)。 可用模板定義元素：$B{} 區(qū)域輸出規(guī)則：這部分區(qū)域取決于$B{}（band數(shù)據(jù)區(qū)）的相應(yīng)輸出規(guī)則。 表結(jié)尾區(qū)：( 3所示區(qū)域) 邊界：最后一個(gè)$B{}定義結(jié)束位置，到整個(gè)模板文件的結(jié)尾部分。 可用模板定義元素：$P{}, $F{}, $V{}區(qū)域輸出規(guī)則：這部分區(qū)域在整個(gè)報(bào)表生成過程中都只輸出一次。且放在整個(gè)生成報(bào)表文件的結(jié)尾部分。 band數(shù)據(jù)區(qū)： band數(shù)據(jù)區(qū)模板定義規(guī)則： $B{name=band1。property=head。dataSource=ds} $B{name=band1。property=body} $B{name=band1。property=foot} $B{name=band1。property=end} 任何一個(gè)band的定義都必須由上述幾部分模板單元組成，其中：name：標(biāo)識(shí)當(dāng)前band名稱，模板分析時(shí)會(huì)根據(jù)該名稱來檢查當(dāng)前band定義是否正確結(jié)束（通過查找headbodyfootend）。property：標(biāo)識(shí)當(dāng)前模板元素是屬于當(dāng)前band的那部分。該屬性有四個(gè)值可供選擇（head，body，foot，end），且必須遵循從上到下headbodyfootend。否則系統(tǒng)會(huì)認(rèn)為當(dāng)前組的模板定義不合法。datasource：定義當(dāng)前band引用的數(shù)據(jù)源，該數(shù)據(jù)源需要在報(bào)表配置文件（）中配置。 詳細(xì)說明：band數(shù)據(jù)區(qū)也分為三個(gè)區(qū)域，這三個(gè)區(qū)域由四個(gè)標(biāo)記屬性來描述，它們分別是：（property=head，property=body，property=foot，property=end），由這四個(gè)屬性值來表示band數(shù)據(jù)區(qū)頭，band數(shù)據(jù)區(qū)，band數(shù)據(jù)區(qū)尾。如下圖： band數(shù)據(jù)區(qū)頭: ( 1所示區(qū)域) 區(qū)域邊界定義：同一個(gè)band（根據(jù)band的name屬性來區(qū)分）的property=head到property=body元素定義之間的區(qū)域?yàn)楫?dāng)前band的數(shù)據(jù)區(qū)頭。( 1所示區(qū)域) 可用模板定義元素：$B{}, $P{}, $F{}, $V{}。 也就是說在band的頭部可以嵌入band，組，以及其他的模板定義元素。 區(qū)域輸出規(guī)則： band數(shù)據(jù)區(qū)頭對(duì)應(yīng)的區(qū)域在每次輸出該band時(shí)都會(huì)輸出一次。 band數(shù)據(jù)區(qū)：( 2所示區(qū)域) 區(qū)域邊界定義：同一個(gè)ba