帆軟實施培訓手冊.

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

2、效率的報表設計方案，采用主流的數(shù)據(jù)雙向擴展，真正無編碼形式設計報表；擁有強大的報表展示功能，并且提供完善的報表權限管理，報表調度管理；具有完備的報表填報功能，支持多級匯總填報。帆軟報表介紹帆軟報表介紹二、帆軟報表服務器部署帆軟報表服務器部署 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項目

3、和.Net項目與帆軟報表集成進行說明。帆軟服務器部署 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。根據(jù)服務區(qū)的版本不同，下載的版本也不同(32位、64位)。帆軟服務器部署 雙擊下載的安裝文件 帆軟服務器部署 配置J

4、ava運行環(huán)境變量帆軟服務器部署 配置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ù)據(jù)集全局性的、所有模板使用語義層數(shù)據(jù)集報表數(shù)據(jù)集單個報表模板的數(shù)據(jù)集報表模板cpt前臺展示View數(shù)據(jù)庫Table/View/Procedures程序代碼 由上圖可以知道，整個報表開發(fā)的過程就是將數(shù)據(jù)與報表模板融合的過程，因此整個開發(fā)過程分為以下幾步：1. 配置數(shù)據(jù)源2. 定義全局數(shù)據(jù)集(可

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

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

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

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

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

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

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

14、布工作。 每次發(fā)布都要進行詳細的記錄，發(fā)布日期、報表名稱、報表功能、適用范圍、報表菜單。 必須先發(fā)布測試版，經客戶確認無誤后，才能發(fā)布正式版。 發(fā)布正式版時，需要在版本控制中添加說明，表明系統(tǒng)提供了新的功能。帆軟報表的測試、發(fā)布 報表模板制作完成后，需要發(fā)布到服務器上進行實際環(huán)境測試。測試過程過中，需要實施人員與客戶進行數(shù)據(jù)、樣式等方面的確認。一旦客戶確認無誤后，則需要發(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ù)據(jù)與正式生產環(huán)境相同，甚至更多，但為測試性質，主要是測試系統(tǒng)bug以及報表展示情況。 正式生產環(huán)境：由客戶確認過的報表以及系統(tǒng)功能，測試無誤后，由專人發(fā)布到正式生產環(huán)境中，并通知客戶。帆軟