【正文】 據(jù)源進(jìn)一步處理，你是無(wú)法在生成的報(bào)表中看到格式化的輸出效果的。來(lái)看一個(gè)例子：$V{SUM($F{}*$F{}) }這個(gè)例子的意思是，將ds數(shù)據(jù)源對(duì)應(yīng)的字段值field1和field2通過(guò)Excel得sum函數(shù)來(lái)做乘法運(yùn)算。需要注意的是該值在不同的數(shù)據(jù)區(qū)還會(huì)產(chǎn)生不同的輸出效果，比如，如果$V{SUM($F{}}放在數(shù)據(jù)源ds對(duì)應(yīng)band的結(jié)尾區(qū)，則該模板的意思是對(duì)ds字段field1的所有記錄值進(jìn)行求和。但并不是所有的數(shù)據(jù)都可以由一條sql語(yǔ)句來(lái)構(gòu)建，比如一些復(fù)雜的數(shù)據(jù)源，其數(shù)據(jù)你可能無(wú)法通過(guò)單句的sql就能檢索出來(lái)，或是不想在程序里面違反唯一性規(guī)則，你想重用原來(lái)的業(yè)務(wù)類，在這樣一些情況下你通常就需要自己手動(dòng)來(lái)構(gòu)建你的數(shù)據(jù)源，那現(xiàn)在的問(wèn)題是在這種情況下我們以一種怎樣方便的可配置的方式來(lái)插入我們的數(shù)據(jù)源構(gòu)建代碼？Excel Report在處理這個(gè)問(wèn)題是通過(guò)一種嵌入對(duì)象的方式，讓用戶可以編寫自己的數(shù)據(jù)處理對(duì)象，并把該對(duì)象以一種可配置的方式嵌入到報(bào)表工具中。此時(shí)拿到dataSources可以調(diào)用：DataSource ds = (DataSource)(groupDs)。還有一種跟快捷的方法往數(shù)據(jù)源中添加數(shù)據(jù)，但必須要求首先list包含的是map對(duì)象，其次每個(gè)Map對(duì)象中必須以字段，字段值的形式保存。 b、在模板文件中使用。獲取當(dāng)前監(jiān)聽器監(jiān)聽的數(shù)據(jù)源對(duì)象實(shí)例。 datasource name=orderreport_ds type=database sql value=select * from orders where CUSTOMERID=39。 在web容器中配置Excel Report（ExcelReportServlet） 你可以直接在你的web應(yīng)用中配置ExcelReport請(qǐng)求處理的Servlet，因?yàn)樵贓xcelReport中系統(tǒng)已經(jīng)實(shí)現(xiàn)了一個(gè)默認(rèn)的Excel報(bào)表請(qǐng)求處理Servlet，通過(guò)配置該servlet你就可以直接把ExcelReport整合到你的項(xiàng)目中去。（可選）4．JNDI 配置默認(rèn)數(shù)據(jù)連結(jié)的jndi （如果沒(méi)配2則必須配置此選項(xiàng)，反之不需配置） 在非web容器環(huán)境下使用excel report.七 一個(gè)完整的報(bào)表示例： 配置模板文件 設(shè)計(jì)嵌入對(duì)象結(jié)束語(yǔ)：。 使用變量別名。獲得參數(shù)的值后可以查詢相關(guān)數(shù)據(jù)，然后將獲得的數(shù)據(jù)放入數(shù)據(jù)源對(duì)象中（ 1所示）。參數(shù)為實(shí)現(xiàn)了IQueryDataListener接口的任何對(duì)象。引用形式：$P{paramName}。來(lái)將所有字段加入數(shù)據(jù)源。2．將你寫好的類嵌入到報(bào)表工具中，通過(guò)在配置文件中配置EmbeddedObject節(jié)點(diǎn)（） 我們可以在嵌入對(duì)象里面做些什么？ ，該接口中有一個(gè)函數(shù)必須實(shí)現(xiàn)：public boolean execute( ReportConfig reportConfig, //報(bào)表配置參數(shù)對(duì)象 Map dataSources, //報(bào)表數(shù)據(jù)源 Map params //傳入?yún)?shù)。 示例：1． 配置一個(gè)卡片式報(bào)表的模板文件2． 配置一個(gè)列表式報(bào)表的模板文件3． 配置一個(gè)主從列表式報(bào)表的模板文件4． 配置一個(gè)分組報(bào)表的模板文件：testGroup5． 配置一個(gè)主從帶分組功能的模板文件 常見問(wèn)題：1. 字段模板大小寫問(wèn)題，當(dāng)你發(fā)現(xiàn)報(bào)表上就是無(wú)法輸出數(shù)據(jù)時(shí)，首先需檢查你的模板定義的字段名稱是否有大小寫問(wèn)題，很多數(shù)據(jù)庫(kù)中檢索出來(lái)的字段名稱默認(rèn)就是大寫的，報(bào)表工具在匹配字段值時(shí)是大小寫敏感的。模板元素說(shuō)明$F{}在Excel函數(shù)模板定義中使用$F{}有以下幾種意思：1． 模板單元格的引用如果我們?cè)贓xcel函數(shù)模板定義($V{})中定義的$F{}在當(dāng)前函數(shù)模板定義之前已經(jīng)定義，則當(dāng)前定義表示對(duì)前一個(gè)單元格的引用，即在$V{}中$F{}對(duì)應(yīng)位置的值會(huì)被被引用的單元格坐標(biāo)代替。2．由于統(tǒng)計(jì)函數(shù)的實(shí)現(xiàn)不是在報(bào)表生成時(shí)去計(jì)算，因此減少了生成報(bào)表數(shù)據(jù)所需要花費(fèi)的時(shí)間。但對(duì)于某些較特殊的值我們還需進(jìn)一步處理：對(duì)于$F{}模板定義的單元格，我們還需要進(jìn)一步判斷該模板變量對(duì)應(yīng)的字段值是否與你需要格式化控制的類型一致，比如，如果我們需要格式化輸出一個(gè)日期型字段，那么我們一定要確保該字段在數(shù)據(jù)源中必須以Date類型的數(shù)據(jù)保存。 4．band和分組的命名盡量簡(jiǎn)短并有意義，當(dāng)然好處自然不用說(shuō)了，這跟我們?cè)诰幊踢^(guò)程中取個(gè)好的變量/函數(shù)名是同樣的道理。 注：可用模板定義元素指的是在當(dāng)前區(qū)域內(nèi)可以定義的模板變量。 可用模板定義元素：$B{}, $G{}, $P{}, $F{}, $V{}。datasource：定義當(dāng)前分組引用的數(shù)據(jù)源，該數(shù)據(jù)源需要在報(bào)表配置文件（）中配置。 dataSource=groupDs} $G{name=group。該數(shù)據(jù)源有多少條記錄，該區(qū)域就會(huì)被重復(fù)輸出多少次。如下圖： band數(shù)據(jù)區(qū)頭: ( 1所示區(qū)域) 區(qū)域邊界定義：同一個(gè)band（根據(jù)band的name屬性來(lái)區(qū)分）的property=head到property=body元素定義之間的區(qū)域?yàn)楫?dāng)前band的數(shù)據(jù)區(qū)頭。property=body} $B{name=band1。報(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ū)。1． 卡片式報(bào)表在目前系統(tǒng)提供的卡片式報(bào)表中，整個(gè)報(bào)表就一個(gè)區(qū)（卡片內(nèi)容區(qū)域），你可以認(rèn)為它沒(méi)有什么表頭，表尾的概念，因?yàn)樗麄€(gè)報(bào)表就一張靜態(tài)的卡片，在這個(gè)卡片區(qū)域內(nèi)我們可以放入：( $P{}, $F{}, $V{} )這樣一些模板元素。$S{}用來(lái)定義在模板對(duì)應(yīng)位置輸出一個(gè)字符串,在該模板變量里面可以嵌入其它模板元素如( $F{}, $P{}, $V{} ) 比如:定義$S{Hello: $F{}} 假設(shè)$F{}當(dāng)前值為39。一個(gè)參數(shù)變量模板元素，表示當(dāng)前模板定義所在的單元格的內(nèi)容在生成報(bào)表過(guò)程中，報(bào)表生成工具會(huì)取參數(shù)變量模板元素定義的參數(shù)值來(lái)替代。接下來(lái)的一節(jié)我們會(huì)詳細(xì)介紹應(yīng)該如何將這樣一些基本的報(bào)表元素放在一個(gè)Excel Report報(bào)表模板中去。（什么是組？） 組數(shù)據(jù)區(qū)：每個(gè)組數(shù)據(jù)輸出部分。當(dāng)然這些基本的概念/規(guī)則同樣適用于其它的報(bào)表工具。 groupby：定義分組字段，如果有多個(gè)字段則各字段間用逗號(hào)（，）分割。全局的datasource定義了一個(gè)數(shù)據(jù)源，而本節(jié)點(diǎn)則定義了該數(shù)據(jù)源的一個(gè)具體實(shí)例。其中每個(gè)sheet才真正對(duì)應(yīng)了一個(gè)具體子報(bào)表的輸出單元。（可以通過(guò)配置，設(shè)定模板文件的一個(gè)公共目錄，這樣系統(tǒng)查找所有的模板文件都會(huì)去該目錄下讀取）2．EmbeddedObject子節(jié)點(diǎn)：該節(jié)點(diǎn)定義當(dāng)前報(bào)表的入口處理類，該類是在生成報(bào)表初期，報(bào)表工具會(huì)調(diào)用該節(jié)點(diǎn)配置的嵌入類信息，并生成相應(yīng)對(duì)象實(shí)例，同時(shí)調(diào)用該對(duì)象的execute函數(shù)來(lái)只需一些用戶定制的代碼。這個(gè)屬性主要是用在格式化輸出上，比如我們要格式化一個(gè)日期型的輸出，假設(shè)我們從數(shù)據(jù)庫(kù)中檢索出來(lái)的字段值是一個(gè)字符串型的日期，那么我們就可以在數(shù)據(jù)源中配置field子節(jié)點(diǎn)，這樣報(bào)表工具會(huì)自動(dòng)將該字符串轉(zhuǎn)化成日期型并寫入到excel文件中去，這樣就可以在生成的excel文件中看到格式化的日期輸出效果了。lt。其中detasource是用來(lái)描述一個(gè)數(shù)據(jù)源的信息，由它來(lái)告訴報(bào)表工具如何去生成一個(gè)具體的數(shù)據(jù)源對(duì)象實(shí)例，我們?cè)谶@個(gè)配置項(xiàng)你們需要回答報(bào)表工具以下幾個(gè)問(wèn)題：1．我需要一個(gè)什么類型的數(shù)據(jù)源？2．這個(gè)數(shù)據(jù)源如何取數(shù)據(jù)（取決于1）。3． 啟動(dòng)tomcat服務(wù)器4． 請(qǐng)求報(bào)表：://localhost:8080/excelreport/report?report=helloworld具體信息可以根據(jù)你web服務(wù)器的具體配置做相應(yīng)調(diào)整?？梢园阉苯涌截惖奖镜氐膖omcat應(yīng)用目錄下運(yùn)行例子程序)本手冊(cè)只針對(duì)ExcelReport的功能及其使用方法進(jìn)行介紹，并未涉及報(bào)表制作相關(guān)的知識(shí)說(shuō)明，因此在閱讀此文檔前必須要求讀者具備一定報(bào)表制作相關(guān)的基礎(chǔ)知識(shí)，且具備一定報(bào)表制作的經(jīng)驗(yàn)，并了解普通報(bào)表設(shè)計(jì)的一般流程。 它與普通報(bào)表工具的區(qū)別： Excel Report是一個(gè)完全基于excel的報(bào)表工具，其最大的特點(diǎn)是完全依賴于excel。 插入查詢監(jiān)聽器：3. 主從式報(bào)表的支持。作者：ajun版本：20061110 一 Excel Report簡(jiǎn)介： 2 什么是Excel Report？ 2 它具有那些功能？ 2 Excel Report的靈活性: 2 它與普通報(bào)表工具的區(qū)別： 3二 體驗(yàn)生成一個(gè)簡(jiǎn)單報(bào)表的制作過(guò)程： 3 運(yùn)行環(huán)境配置 3 開始制作一個(gè)簡(jiǎn)單的報(bào)表 4三 4 設(shè)計(jì)一個(gè)報(bào)表需要配置那些信息？ 5 datasource 節(jié)點(diǎn) 5 report節(jié)點(diǎn) 7 配置文件配置信息規(guī)范建議 9四 報(bào)表模板文件配置 9 報(bào)表模板中的基本元素 10 Excel Report模板文件的構(gòu)成 12 報(bào)表模板配置規(guī)范建議 16 格式化輸出控制 16 通過(guò)$V{}(Excel函數(shù)模板)來(lái)使用excel的函數(shù) 17 示例： 18 常見問(wèn)題： 18五 設(shè)計(jì)報(bào)表嵌入對(duì)象 18 為什么需要設(shè)計(jì)報(bào)表嵌入對(duì)象？ 18 我們可以在嵌入對(duì)象里面做些什么？ 19 一個(gè)嵌入對(duì)象實(shí)例： 19六 使用Excel Report的高級(jí)特性： 19 擴(kuò)充你自己的數(shù)據(jù)源。 2. 列表式報(bào)表的支持。比如，用戶可以在生成報(bào)表前來(lái)組合自己的數(shù)據(jù)源，在這里用戶完全可以充分利用現(xiàn)有系統(tǒng)的相關(guān)業(yè)務(wù)類來(lái)生成自己的數(shù)據(jù)源。（對(duì)于數(shù)據(jù)庫(kù)自動(dòng)檢索數(shù)據(jù)類數(shù)據(jù)源的應(yīng)用場(chǎng)合尤其有用）這些特性在后面的章節(jié)我們會(huì)做詳細(xì)的介紹。(注：你可以在example/。