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

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

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

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

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

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

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

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

9、表文件,帆軟報表模板開發(fā),帆軟報表模板開發(fā),因為有數(shù)據集有全局數(shù)據集，報表數(shù)據集之分。所以以下開發(fā)過程將針對各個數(shù)據集進行說明。 全局數(shù)據集方式,帆軟報表模板開發(fā),首先添加報表參數(shù)。當前添加為報表參數(shù)。標紅部分為參數(shù)單元格，右鍵控件設置出現(xiàn)設置菜單。,帆軟報表模板開發(fā),帆軟報表模板開發(fā),帆軟報表參數(shù)有兩種分類方式，分別對應與不同的使用情況。 按照作用域分：單個報表參數(shù)與全局參數(shù) 按照類型分為：數(shù)據集參數(shù)與數(shù)據源參數(shù) 數(shù)據集參數(shù)：主要對數(shù)據集中的數(shù)據進行過濾 參數(shù)不會影響數(shù)據集中的數(shù)據，只 會影響展示數(shù)據。 數(shù)據源參數(shù)：直接影響數(shù)據集數(shù)據。 所有參數(shù)可以統(tǒng)稱為報表參數(shù)。,帆軟報表模板開發(fā),參數(shù)設

10、置完后，我們進行數(shù)據結果的綁定以及數(shù)據過濾的處理。模板效果圖如下：,帆軟報表模板開發(fā),帆軟報表模板開發(fā),首先對裝置單元格數(shù)據進行過濾，指定只有工廠名稱與參數(shù)相同的數(shù)據才能顯示。,帆軟報表模板開發(fā),設定單元格的擴展方向，默認為從上到下，此處修改為從左到右。,帆軟報表模板開發(fā),對班組單元格添加了兩條數(shù)據過濾條件： 1、工廠與參數(shù)值相同；2、裝置與C單元格相同,帆軟報表模板開發(fā),設定報表標題頭為所選工廠名稱加上“裝置列表”,帆軟報表模板開發(fā),雙擊報表參數(shù)，然后手動在后面不上字符串，加號鏈接。,帆軟報表模板開發(fā),效果展示,帆軟報表模板開發(fā),報表數(shù)據集：依托為某張報表而存在的數(shù)據集 首先添加數(shù)據庫數(shù)據集

11、。,帆軟報表模板開發(fā),此時點擊參數(shù)設計，添加報表參數(shù)。會發(fā)現(xiàn)在左側參數(shù)欄中自動出現(xiàn)我們在數(shù)據源中設置的參數(shù)，右邊參數(shù)模板也會默認提供參數(shù)名以及參數(shù)框。在參數(shù)框上單擊右鍵空間設置會發(fā)現(xiàn)，默認已經將空間名稱綁定為參數(shù)名稱。如果有多個參數(shù)時，需要手工選擇。,帆軟報表模板開發(fā),我們此時要做的就是為當前參數(shù)提供數(shù)據源，并修改參數(shù)名稱。,帆軟報表模板開發(fā),我們此時要做的就是為當前參數(shù)提供數(shù)據源，并修改參數(shù)名稱。,帆軟報表模板開發(fā),接下來的步驟與使用全局數(shù)據集基本相同，只有一個地方不同。因為我們使用了數(shù)據源參數(shù)，那么結果集中所提供的數(shù)據都是滿足參數(shù)條件的。所以不需要再設置“裝置字段”的過濾條件了，只要設置其

12、擴展方向。,帆軟報表模板開發(fā),對班組單元格添加了兩條數(shù)據過濾條件： 1、工廠與參數(shù)值相同；2、裝置與C單元格相同,帆軟報表模板開發(fā),設定報表標題頭為所選工廠名稱加上“裝置列表”,帆軟報表模板開發(fā),雙擊報表參數(shù)，然后手動在后面不上字符串，加號鏈接。,帆軟報表模板開發(fā),展示效果,帆軟報表模板開發(fā),語義層數(shù)據集 首先明確什么是語義層？其次語義層在帆軟中的作用？ 語義層通常應用于web報表軟件中，作用是把數(shù)據庫中的對象進行包裝，產生高度面向業(yè)務的數(shù)據抽取模型。經過這種處理后，數(shù)據處理可以在業(yè)務層面上進行，在生成報表的時候，處理邏輯清晰。,帆軟報表模板開發(fā),語義層在帆軟中的作用 以目前的情況來，語義層主

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

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