帆軟實施培訓(xùn)手冊【行業(yè)研究】

1、帆軟報表開發(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報表工具提供了易用且高效率的報表設(shè)計方案，采用主流

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

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

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

5、軟服務(wù)器工程目錄,帆軟服務(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ù)器部

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

7、開發(fā)過程分為以下幾步： 配置數(shù)據(jù)源 定義全局?jǐn)?shù)據(jù)集(可選) 創(chuàng)建報表文件 為報表文件指定或創(chuàng)建數(shù)據(jù)集 將數(shù)據(jù)集中的數(shù)據(jù)與報表文件融合 預(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ā)過程。上圖報表作用是按照工廠展示其裝置和班組信息。其中有一個搜索條件-工廠。其中裝置為橫向擴展，班組為縱向擴展。,帆

8、軟報表模板開發(fā),1、配置數(shù)據(jù)源 帆軟報表可以使用多種數(shù)據(jù)來源，其中主要分為三大類：文件、數(shù)據(jù)庫、程序。 文件：包括文本、excel、xml，需要符合特定的格式。 數(shù)據(jù)庫：包括表、視圖、存儲過程。 程序：僅支持Java程序，要求實現(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)建報

9、表文件,帆軟報表模板開發(fā),帆軟報表模板開發(fā),因為有數(shù)據(jù)集有全局?jǐn)?shù)據(jù)集，報表數(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)與不同的使用情況。 按照作用域分：單個報表參數(shù)與全局參數(shù) 按照類型分為：數(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è)

10、置完后，我們進(jìn)行數(shù)據(jù)結(jié)果的綁定以及數(shù)據(jù)過濾的處理。模板效果圖如下：,帆軟報表模板開發(fā),帆軟報表模板開發(fā),首先對裝置單元格數(shù)據(jù)進(jìn)行過濾，指定只有工廠名稱與參數(shù)相同的數(shù)據(jù)才能顯示。,帆軟報表模板開發(fā),設(shè)定單元格的擴展方向，默認(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ù)集

11、。,帆軟報表模板開發(fā),此時點擊參數(shù)設(shè)計，添加報表參數(shù)。會發(fā)現(xiàn)在左側(cè)參數(shù)欄中自動出現(xiàn)我們在數(shù)據(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ù)集基本相同，只有一個地方不同。因為我們使用了數(shù)據(jù)源參數(shù)，那么結(jié)果集中所提供的數(shù)據(jù)都是滿足參數(shù)條件的。所以不需要再設(shè)置“裝置字段”的過濾條件了，只要設(shè)置其

12、擴展方向。,帆軟報表模板開發(fā),對班組單元格添加了兩條數(shù)據(jù)過濾條件： 1、工廠與參數(shù)值相同；2、裝置與C單元格相同,帆軟報表模板開發(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ā),語義層在帆軟中的作用 以目前的情況來，語義層主

13、要為實施人員提供的。因為隨著系統(tǒng)所使用的數(shù)據(jù)表越來越多，實施人員無法完全了解每張表、每個字段的作用。因此產(chǎn)生了語義層作用，開發(fā)人員將表的每個字段都轉(zhuǎn)為對應(yīng)的漢語意義，供實施人員在制作報表時使用。 使用語義層時存在以下幾個問題： 1、性能問題，使用時存在字段與表現(xiàn)值的轉(zhuǎn)換問題 2、空間問題，需要建立額外的表存放對照信息，特 別是當(dāng)同名字段映射為不同含義時， 需要的表會越來越多。,帆軟報表模板開發(fā),語義層的替代方案： 如果在開發(fā)過程中，數(shù)據(jù)庫文檔齊全。實施人員在設(shè)計報表時，完全可以不使用語義層進(jìn)行轉(zhuǎn)換。,帆軟報表模板開發(fā),四、帆軟報表測試、發(fā)布,帆軟報表的測試、發(fā)布,1、報表的測試、發(fā)布 報表的開

14、發(fā)工作由各個實施人員單獨完場。但是對于報表的發(fā)布(測試版、正式版)，與系統(tǒng)的集成，都應(yīng)遵循以下原則： 由專人負(fù)責(zé)測試版、正式版的發(fā)布工作。 每次發(fā)布都要進(jìn)行詳細(xì)的記錄，發(fā)布日期、報表名稱、報表功能、適用范圍、報表菜單。 必須先發(fā)布測試版，經(jīng)客戶確認(rèn)無誤后，才能發(fā)布正式版。 發(fā)布正式版時，需要在版本控制中添加說明，表明系統(tǒng)提供了新的功能。,帆軟報表的測試、發(fā)布,報表模板制作完成后，需要發(fā)布到服務(wù)器上進(jìn)行實際環(huán)境測試。測試過程過中，需要實施人員與客戶進(jìn)行數(shù)據(jù)、樣式等方面的確認(rèn)。一旦客戶確認(rèn)無誤后，則需要發(fā)布到正式生產(chǎn)環(huán)境供客戶使用。 因此，對應(yīng)于報表的整個開發(fā)、測試、發(fā)布，每一步都需要一個相應(yīng)的運行環(huán)境。,帆軟報表的測試、發(fā)布,本地開發(fā)環(huán)境,服務(wù)器測試生產(chǎn)環(huán)境,服務(wù)器正式生產(chǎn)環(huán)境,實施人員電腦,系統(tǒng)服務(wù)器,服務(wù)器開發(fā)測試環(huán)境,因為存在實施人員本地開發(fā)提示授權(quán)問題，為了解決這個問題。由上圖可知，對于服務(wù)區(qū)上需要存在至少三個環(huán)境：開發(fā)測試環(huán)境，測試生產(chǎn)環(huán)境，正式生產(chǎn)環(huán)境 開發(fā)測試環(huán)境：實施人員將本地開發(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)境中，并通知客戶。,帆