帆軟實(shí)施培訓(xùn)手冊.

1、帆帆軟報表開發(fā)、部署培訓(xùn)手冊軟報表開發(fā)、部署培訓(xùn)手冊BBRIGHTWAY名道恒通名道恒通一帆軟報表介紹二帆軟表報服務(wù)器部署三帆軟報表模板的開發(fā)四帆軟報表的測試、發(fā)布大綱大綱一、帆軟報表介紹帆軟報表介紹 FineReport報表軟件是帆軟軟件（中國）公司自主研發(fā)的一款純Java編寫的企業(yè)級web報表軟件。FineReport是基于J2EE和WEB的綜合報表解決方案，特有的EXCEL+綁定數(shù)據(jù)列的報表設(shè)計方式，支持多源分片，行列對稱，能夠輕松處理復(fù)雜的報表展現(xiàn)樣式，全面支持主流的B/S架構(gòu)以及傳統(tǒng)的C/S架構(gòu)，部署方式簡單而靈活，完美解決中國式報表難題。 FineReport報表工具提供了易用且高

2、效率的報表設(shè)計方案，采用主流的數(shù)據(jù)雙向擴(kuò)展，真正無編碼形式設(shè)計報表；擁有強(qiáng)大的報表展示功能，并且提供完善的報表權(quán)限管理，報表調(diào)度管理；具有完備的報表填報功能，支持多級匯總填報。帆軟報表介紹帆軟報表介紹二、帆軟報表服務(wù)器部署帆軟報表服務(wù)器部署 FineReport是基于J2EE和WEB的綜合報表解決方案。所以就決定了帆軟報表需要運(yùn)行在Java環(huán)境下。雖然是運(yùn)行在Java環(huán)境下，但是同樣可以應(yīng)用到.Net的系統(tǒng)中。對于Java項(xiàng)目，與帆軟集成非常容易，因?yàn)閮烧弑旧矶际荍ava運(yùn)行環(huán)境，可以實(shí)現(xiàn)無縫式嵌入。對于.Net系統(tǒng)，則需要單獨(dú)部署一套J2EE容器來為帆軟提供運(yùn)行環(huán)境。下面就分別對Java項(xiàng)目

3、和.Net項(xiàng)目與帆軟報表集成進(jìn)行說明。帆軟服務(wù)器部署 1、與.Net系統(tǒng)集成 對于.Net系統(tǒng)，首先需要在服務(wù)區(qū)上部署Java運(yùn)行環(huán)境。在系統(tǒng)中部署Java運(yùn)行環(huán)境有以下幾步： 安裝并配置Java運(yùn)行庫(JDK/JRE) 安裝tomcat(輕量級的J2EE容器) 部署帆軟報表服務(wù)器，測試是否部署成功 進(jìn)行IIS與tomcat的系統(tǒng)集成 測試IIS與tomcat集成是否成功帆軟服務(wù)器部署1、安裝并配置Java運(yùn)行庫(JDK/JRE) 首先從Oracle網(wǎng)站下載Java運(yùn)行庫JDK。根據(jù)服務(wù)區(qū)的版本不同，下載的版本也不同(32位、64位)。帆軟服務(wù)器部署 雙擊下載的安裝文件 帆軟服務(wù)器部署 配置J

4、ava運(yùn)行環(huán)境變量帆軟服務(wù)器部署 配置Java運(yùn)行環(huán)境變量帆軟服務(wù)器部署2、部署tomcat服務(wù)器 首先從apache官網(wǎng)下載tomcat(版本無所謂)帆軟服務(wù)器部署 將下載的zip文件解壓到任意目錄 點(diǎn)擊tomcat目錄下的bin目錄中startup.bat帆軟服務(wù)器部署 如果啟動成功，則需要將tomcat做成系統(tǒng)服務(wù)帆軟服務(wù)器部署3、部署帆軟報表服務(wù)器 首先到帆軟的網(wǎng)站下在最新的帆軟設(shè)計器客戶端，雙擊下載后的安裝文件帆軟服務(wù)器部署 當(dāng)你能看見當(dāng)前界面時，恭喜你，安裝成功！帆軟服務(wù)器部署 下圖為帆軟的安裝目錄，其中有兩個目錄比較重要document：帆軟教程目錄 WebReport：帆軟服務(wù)

5、器工程目錄帆軟服務(wù)器部署 接下里要做的事情，就是將WebReport目標(biāo)原封不動的拷貝到我們之前部署的tomcat中，目錄如下。接著需要重啟tomcat，當(dāng)然你看到如下畫面時，恭喜你，部署成功。帆軟服務(wù)器部署4、進(jìn)行IIS與tomcat集成 將附件提供的文件拷貝到tomcat對應(yīng)的目錄中。其中ISAPI為新建目錄，拷貝后的結(jié)果如下：帆軟服務(wù)器部署 關(guān)于conf中的文件配置說明：帆軟服務(wù)器部署 關(guān)于ISAPI中的文件配置說明：帆軟服務(wù)器部署 關(guān)于IIS部分配置說明。首先要在IIS的web引用工程上新增虛擬目錄。帆軟服務(wù)器部署 為你的Web系統(tǒng)添加ISAPI篩選器帆軟服務(wù)器部署帆軟服務(wù)器部署 重啟

6、IIS和tomcat后，驗(yàn)證配置是否成功帆軟服務(wù)器部署 2、與Java系統(tǒng)集成 因?yàn)榉泩蟊硎腔贘ava開發(fā)的，所以可以實(shí)現(xiàn)與Java項(xiàng)目的無縫式集成。對于兩者的集成，建議由開發(fā)人員直接進(jìn)行項(xiàng)目集成。帆軟服務(wù)器部署三、帆軟報表模板制作帆軟報表模板開發(fā)帆軟報表模板開發(fā)文件文本文件/Xml/Excel服務(wù)器數(shù)據(jù)集全局性的、所有模板使用語義層數(shù)據(jù)集報表數(shù)據(jù)集單個報表模板的數(shù)據(jù)集報表模板cpt前臺展示View數(shù)據(jù)庫Table/View/Procedures程序代碼 由上圖可以知道，整個報表開發(fā)的過程就是將數(shù)據(jù)與報表模板融合的過程，因此整個開發(fā)過程分為以下幾步：1. 配置數(shù)據(jù)源2. 定義全局?jǐn)?shù)據(jù)集(可

7、選)3. 創(chuàng)建報表文件4. 為報表文件指定或創(chuàng)建數(shù)據(jù)集5. 將數(shù)據(jù)集中的數(shù)據(jù)與報表文件融合6. 預(yù)覽帆軟報表模板開發(fā) 上面的步驟是開發(fā)報表的基本流程。其中全局?jǐn)?shù)據(jù)集不是必備，對于很通用的數(shù)據(jù)，可以做為全局?jǐn)?shù)據(jù)集，供所有報表引用 。如果開發(fā)環(huán)境與部署環(huán)境不在同一個環(huán)境下，那么要注意數(shù)據(jù)源的配置。下圖為帆軟數(shù)據(jù)源的配置文件及存放目錄，如果兩個環(huán)境不同，需要將本地的數(shù)據(jù)源配置同步到服務(wù)器上。帆軟報表模板開發(fā) 下面就以上圖為例，講述整個報表的開發(fā)過程。上圖報表作用是按照工廠展示其裝置和班組信息。其中有一個搜索條件-工廠。其中裝置為橫向擴(kuò)展，班組為縱向擴(kuò)展。帆軟報表模板開發(fā)1、配置數(shù)據(jù)源 帆軟報表可以使

8、用多種數(shù)據(jù)來源，其中主要分為三大類：文件、數(shù)據(jù)庫、程序。 文件：包括文本、excel、xml，需要符合特定的格式。 數(shù)據(jù)庫：包括表、視圖、存儲過程。 程序：僅支持Java程序，要求實(shí)現(xiàn)特定的接口。 每一類都有特定的使用場景。其中最常用的就是數(shù)據(jù)庫方式；文件主要適用于需要導(dǎo)入獲取數(shù)據(jù)的場景；程序主要是為需要有開發(fā)人員直接開發(fā)報表的場景；多數(shù)時候，可以被數(shù)據(jù)庫方式所替代。 下面就以數(shù)據(jù)庫方式講解報表的制作及數(shù)據(jù)融合過程。帆軟報表模板開發(fā)配置數(shù)據(jù)源帆軟報表模板開發(fā)帆軟報表模板開發(fā)2、定義全局?jǐn)?shù)據(jù)集帆軟報表模板開發(fā)帆軟報表模板開發(fā)3、創(chuàng)建報表文件帆軟報表模板開發(fā)帆軟報表模板開發(fā) 因?yàn)橛袛?shù)據(jù)集有全局?jǐn)?shù)據(jù)

9、集，報表數(shù)據(jù)集之分。所以以下開發(fā)過程將針對各個數(shù)據(jù)集進(jìn)行說明。 全局?jǐn)?shù)據(jù)集方式帆軟報表模板開發(fā) 首先添加報表參數(shù)。當(dāng)前添加為報表參數(shù)。標(biāo)紅部分為參數(shù)單元格，右鍵控件設(shè)置出現(xiàn)設(shè)置菜單。帆軟報表模板開發(fā)帆軟報表模板開發(fā) 帆軟報表參數(shù)有兩種分類方式，分別對應(yīng)與不同的使用情況。a) 按照作用域分：單個報表參數(shù)與全局參數(shù)b) 按照類型分為：數(shù)據(jù)集參數(shù)與數(shù)據(jù)源參數(shù) 數(shù)據(jù)集參數(shù)：主要對數(shù)據(jù)集中的數(shù)據(jù)進(jìn)行過濾 參數(shù)不會影響數(shù)據(jù)集中的數(shù)據(jù)，只 會影響展示數(shù)據(jù)。 數(shù)據(jù)源參數(shù)：直接影響數(shù)據(jù)集數(shù)據(jù)。 所有參數(shù)可以統(tǒng)稱為報表參數(shù)。帆軟報表模板開發(fā) 參數(shù)設(shè)置完后，我們進(jìn)行數(shù)據(jù)結(jié)果的綁定以及數(shù)據(jù)過濾的處理。模板效果圖如下：

10、帆軟報表模板開發(fā)帆軟報表模板開發(fā) 首先對裝置單元格數(shù)據(jù)進(jìn)行過濾，指定只有工廠名稱與參數(shù)相同的數(shù)據(jù)才能顯示。帆軟報表模板開發(fā) 設(shè)定單元格的擴(kuò)展方向，默認(rèn)為從上到下，此處修改為從左到右。帆軟報表模板開發(fā)對班組單元格添加了兩條數(shù)據(jù)過濾條件：1、工廠與參數(shù)值相同；2、裝置與C單元格相同 帆軟報表模板開發(fā)設(shè)定報表標(biāo)題頭為所選工廠名稱加上“裝置列表” 帆軟報表模板開發(fā)雙擊報表參數(shù)，然后手動在后面不上字符串，加號鏈接。帆軟報表模板開發(fā)效果展示帆軟報表模板開發(fā) 報表數(shù)據(jù)集：依托為某張報表而存在的數(shù)據(jù)集 首先添加數(shù)據(jù)庫數(shù)據(jù)集。帆軟報表模板開發(fā) 此時點(diǎn)擊參數(shù)設(shè)計，添加報表參數(shù)。會發(fā)現(xiàn)在左側(cè)參數(shù)欄中自動出現(xiàn)我們在數(shù)

11、據(jù)源中設(shè)置的參數(shù)，右邊參數(shù)模板也會默認(rèn)提供參數(shù)名以及參數(shù)框。在參數(shù)框上單擊右鍵空間設(shè)置會發(fā)現(xiàn)，默認(rèn)已經(jīng)將空間名稱綁定為參數(shù)名稱。如果有多個參數(shù)時，需要手工選擇。帆軟報表模板開發(fā) 我們此時要做的就是為當(dāng)前參數(shù)提供數(shù)據(jù)源，并修改參數(shù)名稱。帆軟報表模板開發(fā) 我們此時要做的就是為當(dāng)前參數(shù)提供數(shù)據(jù)源，并修改參數(shù)名稱。帆軟報表模板開發(fā) 接下來的步驟與使用全局?jǐn)?shù)據(jù)集基本相同，只有一個地方不同。因?yàn)槲覀兪褂昧藬?shù)據(jù)源參數(shù)，那么結(jié)果集中所提供的數(shù)據(jù)都是滿足參數(shù)條件的。所以不需要再設(shè)置“裝置字段”的過濾條件了，只要設(shè)置其擴(kuò)展方向。帆軟報表模板開發(fā)對班組單元格添加了兩條數(shù)據(jù)過濾條件：1、工廠與參數(shù)值相同；2、裝置與C

12、單元格相同 帆軟報表模板開發(fā)設(shè)定報表標(biāo)題頭為所選工廠名稱加上“裝置列表” 帆軟報表模板開發(fā)雙擊報表參數(shù)，然后手動在后面不上字符串，加號鏈接。帆軟報表模板開發(fā)展示效果帆軟報表模板開發(fā)語義層數(shù)據(jù)集 首先明確什么是語義層？其次語義層在帆軟中的作用？ 語義層通常應(yīng)用于web報表軟件中，作用是把數(shù)據(jù)庫中的對象進(jìn)行包裝，產(chǎn)生高度面向業(yè)務(wù)的數(shù)據(jù)抽取模型。經(jīng)過這種處理后，數(shù)據(jù)處理可以在業(yè)務(wù)層面上進(jìn)行，在生成報表的時候，處理邏輯清晰。帆軟報表模板開發(fā)語義層在帆軟中的作用 以目前的情況來，語義層主要為實(shí)施人員提供的。因?yàn)殡S著系統(tǒng)所使用的數(shù)據(jù)表越來越多，實(shí)施人員無法完全了解每張表、每個字段的作用。因此產(chǎn)生了語義層作

13、用，開發(fā)人員將表的每個字段都轉(zhuǎn)為對應(yīng)的漢語意義，供實(shí)施人員在制作報表時使用。 使用語義層時存在以下幾個問題： 1、性能問題，使用時存在字段與表現(xiàn)值的轉(zhuǎn)換問題 2、空間問題，需要建立額外的表存放對照信息，特 別是當(dāng)同名字段映射為不同含義時， 需要的表會越來越多。帆軟報表模板開發(fā)語義層的替代方案： 如果在開發(fā)過程中，數(shù)據(jù)庫文檔齊全。實(shí)施人員在設(shè)計報表時，完全可以不使用語義層進(jìn)行轉(zhuǎn)換。帆軟報表模板開發(fā)四、帆軟報表測試、發(fā)布帆軟報表的測試、發(fā)布1、報表的測試、發(fā)布 報表的開發(fā)工作由各個實(shí)施人員單獨(dú)完場。但是對于報表的發(fā)布(測試版、正式版)，與系統(tǒng)的集成，都應(yīng)遵循以下原則： 由專人負(fù)責(zé)測試版、正式版的發(fā)

14、布工作。 每次發(fā)布都要進(jìn)行詳細(xì)的記錄，發(fā)布日期、報表名稱、報表功能、適用范圍、報表菜單。 必須先發(fā)布測試版，經(jīng)客戶確認(rèn)無誤后，才能發(fā)布正式版。 發(fā)布正式版時，需要在版本控制中添加說明，表明系統(tǒng)提供了新的功能。帆軟報表的測試、發(fā)布 報表模板制作完成后，需要發(fā)布到服務(wù)器上進(jìn)行實(shí)際環(huán)境測試。測試過程過中，需要實(shí)施人員與客戶進(jìn)行數(shù)據(jù)、樣式等方面的確認(rèn)。一旦客戶確認(rèn)無誤后，則需要發(fā)布到正式生產(chǎn)環(huán)境供客戶使用。 因此，對應(yīng)于報表的整個開發(fā)、測試、發(fā)布，每一步都需要一個相應(yīng)的運(yùn)行環(huán)境。帆軟報表的測試、發(fā)布本地開發(fā)環(huán)境服務(wù)器測試生產(chǎn)環(huán)境服務(wù)器正式生產(chǎn)環(huán)境實(shí)施人員電腦系統(tǒng)服務(wù)器服務(wù)器開發(fā)測試環(huán)境 因?yàn)榇嬖趯?shí)施人員本地開發(fā)提示授權(quán)問題，為了解決這個問題。由上圖可知，對于服務(wù)區(qū)上需要存在至少三個環(huán)境：開發(fā)測試環(huán)境，測試生產(chǎn)環(huán)境，正式生產(chǎn)環(huán)境 開發(fā)測試環(huán)境：實(shí)施人員將本地開發(fā)好的模板上傳到該環(huán)境測試，解決出現(xiàn)需要授權(quán)問題。 測試生產(chǎn)環(huán)境：此環(huán)境下的數(shù)據(jù)與正式生產(chǎn)環(huán)境相同，甚至更多，但為測試性質(zhì)，主要是測試系統(tǒng)bug以及報表展示情況。 正式生產(chǎn)環(huán)境：由客戶確認(rèn)過的報表以及系統(tǒng)功能，測試無誤后，由專人發(fā)布到正式生產(chǎn)環(huán)境中，并通知客戶。帆軟