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

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

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

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

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

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

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

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

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

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

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

11、。,帆軟報(bào)表模板開(kāi)發(fā),此時(shí)點(diǎn)擊參數(shù)設(shè)計(jì)，添加報(bào)表參數(shù)。會(huì)發(fā)現(xiàn)在左側(cè)參數(shù)欄中自動(dòng)出現(xiàn)我們?cè)跀?shù)據(jù)源中設(shè)置的參數(shù)，右邊參數(shù)模板也會(huì)默認(rèn)提供參數(shù)名以及參數(shù)框。在參數(shù)框上單擊右鍵空間設(shè)置會(huì)發(fā)現(xiàn)，默認(rèn)已經(jīng)將空間名稱綁定為參數(shù)名稱。如果有多個(gè)參數(shù)時(shí)，需要手工選擇。,帆軟報(bào)表模板開(kāi)發(fā),我們此時(shí)要做的就是為當(dāng)前參數(shù)提供數(shù)據(jù)源，并修改參數(shù)名稱。,帆軟報(bào)表模板開(kāi)發(fā),我們此時(shí)要做的就是為當(dāng)前參數(shù)提供數(shù)據(jù)源，并修改參數(shù)名稱。,帆軟報(bào)表模板開(kāi)發(fā),接下來(lái)的步驟與使用全局?jǐn)?shù)據(jù)集基本相同，只有一個(gè)地方不同。因?yàn)槲覀兪褂昧藬?shù)據(jù)源參數(shù)，那么結(jié)果集中所提供的數(shù)據(jù)都是滿足參數(shù)條件的。所以不需要再設(shè)置“裝置字段”的過(guò)濾條件了，只要設(shè)置其

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

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

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