潤乾報(bào)表使用手冊

1、精選優(yōu)質(zhì)文檔-傾情為你奉上報(bào)表使用手冊XX股份有限公司中國 濟(jì)南目錄1 概述該文檔主要滿足iES-E200電量采集系統(tǒng)中自定義報(bào)表制作編寫。2 安裝2.1 準(zhǔn)備好安裝程序2.2 安裝中的選項(xiàng)點(diǎn)擊安裝程序，安裝過程中會出現(xiàn)一下選擇界面，請注意選擇；2.3 授權(quán)文件配置啟動報(bào)表設(shè)計(jì)器（），點(diǎn)擊“系統(tǒng)/數(shù)據(jù)源”菜單，彈出窗口如下圖所示：3 報(bào)表制作使用自定義報(bào)表的一個(gè)顯著特點(diǎn)需要顯示的對象具有某一項(xiàng)相同的屬性，若沒有相同屬性可以人工設(shè)置相同屬性； 方法一：對對象進(jìn)行編碼設(shè)置（可以利用母線、變壓器編碼信息進(jìn)行人工設(shè)置相同屬性）；方法二：可以將對象添加到其他電量公式中；3.1 報(bào)表制作要求 支持非自然日

2、查詢； 支持非自然月查詢； 支持表碼異常提示； 日、多日、月報(bào)表通用； 表碼小數(shù)位數(shù)顯示為4位；3.2 制作一張報(bào)表的步驟3.3 啟動報(bào)表設(shè)計(jì)器啟動報(bào)表設(shè)計(jì)器的方式有三種方法：方法一：在安裝目錄（比如默認(rèn)的安裝目錄：C:Program FilesreportHomebin）尋找startup.bat的程序文件，雙擊運(yùn)行即可；方法二：從程序組中選擇：開始 - 程序 - 潤乾報(bào)表 - 潤乾報(bào)表設(shè)計(jì)器方法三：安裝完潤乾報(bào)表之后，在桌面上會出現(xiàn)潤乾報(bào)表設(shè)計(jì)器的快捷方式，雙擊即可。潤乾報(bào)表設(shè)計(jì)器的主界面，如下圖所示：3.4 連接3.4.1 數(shù)據(jù)源對話框點(diǎn)擊“配置/數(shù)據(jù)源”菜單，進(jìn)入以下對話框：3.4.2

3、 編輯數(shù)據(jù)源如果有已編輯好的數(shù)據(jù)源，點(diǎn)擊“連接”按鈕。如果沒有已編輯好的數(shù)據(jù)源，點(diǎn)擊“新建”按鈕，增加一個(gè)數(shù)據(jù)源，數(shù)據(jù)源的編輯界面如下：選擇“關(guān)系型數(shù)據(jù)庫”，點(diǎn)擊“確定”按鈕，進(jìn)入下面的頁面：在這里，我們將數(shù)據(jù)源名稱命名為jdbc/RCCEEI，數(shù)據(jù)庫類型選擇ORACLE，客戶端字符集選擇GBK，數(shù)據(jù)字符集選擇GBK，驅(qū)動程序選擇oracle.jdbc.driver.OracleDriver，數(shù)據(jù)源URL為jdbc:oracle:thin:數(shù)據(jù)庫IP:1521:db，用戶為XXX,密碼為?，點(diǎn)擊“確定”按鈕，建立此數(shù)據(jù)源. 至此，數(shù)據(jù)源建立完畢，點(diǎn)擊“配置數(shù)據(jù)源”，選中要連接的數(shù)據(jù)源，點(diǎn)擊“連

4、接”按鈕，連接詞數(shù)據(jù)源。3.4.3 注意事項(xiàng)需要和tomcat連接池配置一致：3.5 設(shè)計(jì)報(bào)表格式3.5.1 格式設(shè)計(jì)方法一：新建報(bào)表新建報(bào)表并根據(jù)客戶需求設(shè)計(jì)報(bào)表格式包含標(biāo)題、報(bào)表頭、數(shù)據(jù)區(qū),如下圖：方法二：導(dǎo)入Excel文件點(diǎn)擊“文件/打開”菜單，彈出窗口如下圖所示：選擇客戶提供的報(bào)表，點(diǎn)擊打開。方法三：根據(jù)現(xiàn)有報(bào)表修改 打開現(xiàn)有的報(bào)表文件，修改該文件使其符合客戶要求；3.5.2 需注意事項(xiàng) 邊框設(shè)置 對齊設(shè)置（字符左對齊，數(shù)字右對齊，標(biāo)題、序號居中） 隱藏不顯示的單元格（行屬性和單元格屬性向沖突時(shí)行屬性優(yōu)先） 刪除沒有用到的單元格3.6 定義3.6.1 參數(shù)的編輯點(diǎn)擊“配置/參數(shù)”菜單，

5、彈出窗口如下圖所示：可以對參數(shù)進(jìn)行添加、修改、刪除等操作；參數(shù)的值是從網(wǎng)頁傳遞過來，此處參數(shù)名稱應(yīng)和網(wǎng)頁一致；3.6.2 常用參數(shù)舉例st：starttime簡拼表示報(bào)表顯示數(shù)據(jù)的開始時(shí)間，目前用秒數(shù)表示；et：endtime簡拼表示報(bào)表顯示數(shù)據(jù)的結(jié)束時(shí)間，目前用秒數(shù)表示；substaid：substationid簡拼表示變電站ID;strhour：非自然日的開始時(shí)間的分鐘數(shù)，8:00表示為：480；strdatetype：報(bào)表的時(shí)間類型，1為日報(bào)表，2為月報(bào)表，3為多日；lst：laststarttime簡拼表示報(bào)表顯示數(shù)據(jù)的開始時(shí)間的去年同期時(shí)間，目前用秒數(shù)表示；let：lastendti

6、me簡拼表示報(bào)表顯示數(shù)據(jù)的結(jié)束時(shí)間的去年同期時(shí)間，目前用秒數(shù)表示；yearsecs：表示報(bào)表顯示數(shù)據(jù)的開始時(shí)間的年初時(shí)間，目前用秒數(shù)表示；lyearsecs：表示報(bào)表顯示數(shù)據(jù)的開始時(shí)間的上一年的年初時(shí)間，目前用秒數(shù)表示；3.7 定義3.7.1 宏的編輯點(diǎn)擊“配置/宏”菜單，彈出窗口如下圖所示：可以對宏進(jìn)行添加、修改、刪除等操作；宏的賦值可以使用具體的數(shù)字、參數(shù)或者表達(dá)式；3.7.2 常用宏舉例1、對參數(shù)進(jìn)行處理的宏startyear= mid(str(dateTime(st*1000),0,4)；表示開始時(shí)間的年份。endyear= mid(str(dateTime(et*1000),0,4)

7、 ；表示開始時(shí)間的月份。startmonth= mid(str(dateTime(st*1000),5,7)；表示結(jié)束時(shí)間的年份。endmonth= mid(str(dateTime(et*1000),5,7)；表示結(jié)束時(shí)間的月份。2、在數(shù)據(jù)集中進(jìn)行替換的宏 3.8 建立3.8.1 數(shù)據(jù)集的編輯點(diǎn)擊“配置/數(shù)據(jù)集”菜單，彈出窗口如下圖所示：可以對數(shù)據(jù)集進(jìn)行添加、刪除、修改等操作；常見數(shù)據(jù)集包括描述信息和歷史數(shù)據(jù)數(shù)據(jù)集；描述信息數(shù)據(jù)集：計(jì)量點(diǎn)數(shù)據(jù)集、母線數(shù)據(jù)集、主變數(shù)據(jù)集、線路數(shù)據(jù)集、CT數(shù)據(jù)集等；歷史數(shù)據(jù)數(shù)據(jù)集：表碼數(shù)據(jù)集、電量數(shù)據(jù)集等；3.8.2 常用數(shù)據(jù)集舉例母線供電量開關(guān)數(shù)據(jù)集：sele

8、ct a.id as id,, a.parts_id as cparts_id, b.parts_type,b.parts_id as parts_id, as switch_name,b.start_date,b.end_date ,c.voltage_level as voltage_level,b.parts_para as parts_para,b.cal_sign as cal_sign,d.voltage_level as gvoltage_levelfrom calc_desc a,calc_para b,switch c ,generatrix d wh

9、ere a.id=b.calc_id and a.parts_type=9 and a.parts_id =d.id and a.parts_para=0 and c.id=b.parts_id and d.substation_id=$substaid and (b.start_date=$starttime)or(b.start_date=$endtime)CT數(shù)據(jù)集：select mp_id,run_date,coef from ct where run_date=$starttime and mp_id in(select b.parts_id as parts_id from cal

10、c_desc a,calc_para b,switch c ,generatrix d where a.id=b.calc_id and a.parts_type=9 母線公式中的計(jì)量點(diǎn)and a.parts_id =d.id and c.id=b.parts_id and d.substation_id=$substaidand (/公式時(shí)效判斷(b.start_date=$starttime) or(b.start_date=$endtime) order by run_date desc電量數(shù)據(jù)集：SELECT mp_id,power_type,sum(total_value) as t

11、otal_value from( select mp_id, mod(power_type,10)+10 as power_type,sum(total_value) as total_value from mp_day_e$year WHERE datetime=$starttime and datetime$endtime and power_type,false,true)，即可按照輸入?yún)?shù)隱藏列。3.9.6 應(yīng)用主要說明在同一張報(bào)表中有幾個(gè)同一類型數(shù)據(jù)區(qū)（如在一張報(bào)表中分別顯示該變電站能所有母線的計(jì)算分量的詳細(xì)信息）；可以根據(jù)實(shí)際情況分別對多條母線分別設(shè)置單元格屬性，更方便的是采用人工

12、干預(yù)主格的方式實(shí)現(xiàn)；以下圖為例說明：1. 首先在A16單元格中設(shè)置需要顯示的母線的ID;2. 在17行到27行完成一條母線的各類數(shù)據(jù)的賦值；3. 從17行到27行設(shè)置左主格為A16;3.10 報(bào)表預(yù)覽報(bào)表預(yù)覽主要用于驗(yàn)證報(bào)表是否正確，點(diǎn)擊工具欄中的預(yù)覽圖標(biāo)，彈出參數(shù)賦值對話框，根據(jù)實(shí)際情況對各個(gè)參數(shù)賦值后，點(diǎn)擊“確定”按鈕；如果預(yù)覽界面正常，說明我們報(bào)表建立成功3.11 報(bào)表發(fā)布 。4 報(bào)表部署4.1 部署位置目前在下放置一些常見的報(bào)表模板部署時(shí)可以根據(jù)實(shí)際情況進(jìn)行刪減；目錄結(jié)構(gòu) -dayreport /放置日報(bào)表模板 -company /放置不需要選擇廠站的日報(bào)表模板 -substation

13、/放置需要選擇廠站的日報(bào)表模板 -monthreport /放置月報(bào)表模板-company /放置需要選擇廠站的月報(bào)表模板 -substation/放置需要選擇廠站的月報(bào)表模板4.2 Web中顯示 在web菜單“數(shù)據(jù)瀏覽”項(xiàng)中的“應(yīng)用日報(bào)表”對應(yīng)自定義日報(bào)表的顯示、“應(yīng)用月報(bào)表”對應(yīng)自定義月報(bào)表的顯示；5 重要概念5.1 數(shù)據(jù)源顧名思義，數(shù)據(jù)的來源。在數(shù)據(jù)源中存儲了所有建立數(shù)據(jù)庫連接的信息。就象通過指定文件名你可以在文件系統(tǒng)中找到文件一樣，通過提供正確的數(shù)據(jù)源名稱，你可以找到相應(yīng)的數(shù)據(jù)庫連接。 數(shù)據(jù)源標(biāo)準(zhǔn)屬性包括： 1、databaseName String 數(shù)據(jù)庫名稱，即數(shù)據(jù)庫的SID。 2

14、、dataSourceName String 數(shù)據(jù)源接口實(shí)現(xiàn)類的名稱。 3、description String 對數(shù)據(jù)源的描述。 4、networkProtocol String 和服務(wù)器通訊使用的網(wǎng)絡(luò)協(xié)議名。 5、password String 用戶登錄密碼。 6、portNumber 數(shù)據(jù)庫服務(wù)器使用的端口。 7、serverName String 數(shù)據(jù)庫服務(wù)器名稱。 8、user String 用戶登錄名。 如果數(shù)據(jù)是水，數(shù)據(jù)庫就是水庫，數(shù)據(jù)源就是連接水庫的管道，終端用戶看到的數(shù)據(jù)集是管道里流出來的水。5.2 數(shù)據(jù)集數(shù)據(jù)集是包含數(shù)據(jù)表的對象，可以在這些數(shù)據(jù)表中臨時(shí)存儲數(shù)據(jù)以便在應(yīng)用程序

15、中使用。如果應(yīng)用程序要求使用數(shù)據(jù)，則可以將該數(shù)據(jù)加載到數(shù)據(jù)集中，數(shù)據(jù)集在本地內(nèi)存中為應(yīng)用程序提供了待用數(shù)據(jù)的緩存。即使應(yīng)用程序從數(shù)據(jù)庫斷開連接，也可以使用數(shù)據(jù)集中的數(shù)據(jù)。數(shù)據(jù)集維護(hù)有關(guān)其數(shù)據(jù)的更改的信息，因此可以跟蹤數(shù)據(jù)更新，并在應(yīng)用程序重新連接時(shí)將更新發(fā)送回?cái)?shù)據(jù)庫。5.3 參數(shù)在我們設(shè)計(jì)一張報(bào)表的時(shí)候，很少有里面的數(shù)據(jù)是固定不變的，常常需要根據(jù)一些條件來過濾出我們想要的數(shù)據(jù)。這就需要通過參數(shù)的形式控制報(bào)表中的數(shù)據(jù)。 下面，根據(jù)前面的報(bào)表，我們加入?yún)?shù)使它變成一張更靈活的報(bào)表。第一步：單擊主菜單中的【配置】-【參數(shù)】。彈出“參數(shù)編輯”窗體，如下圖所示： 第二步：點(diǎn)擊【增加】按鈕，新增一個(gè)參數(shù)，

16、默認(rèn)名稱為“arg1”，名稱可根據(jù)自己的需要來命名。這里我們把【名稱】和【描述】分別改成“name”和“員工姓名”，【數(shù)據(jù)類型】我們選擇默認(rèn)的“字符串”。如下圖所示： 同樣的方法增加一個(gè)“獎金”參數(shù)，【數(shù)據(jù)類型】設(shè)置為“數(shù)值型”。同樣的方法增加一個(gè)“出生日期”參數(shù)，【數(shù)據(jù)類型】設(shè)置為“日期型”。同樣的方法增加一個(gè)“性別”參數(shù)，【數(shù)據(jù)類型】設(shè)置為“字符串”。注：n 參數(shù)名稱盡量用英文，中文容易在部署的時(shí)候出現(xiàn)亂碼，徒增煩惱。n 在sql語句中不能使用參數(shù)5.4 宏定義宏是一個(gè)沒有數(shù)據(jù)類型的字符串標(biāo)識，在報(bào)表運(yùn)算之前，系統(tǒng)會全面搜索整張報(bào)表的表達(dá)式定義，將所有的宏名替換成宏值。利用宏可以在報(bào)表中動

17、態(tài)的進(jìn)行表達(dá)式的替換，根據(jù)用戶傳入的不同宏值，在報(bào)表中可以計(jì)算出不同的表達(dá)式結(jié)果，從而得到不同的報(bào)表信息，這樣用戶就不用根據(jù)不同的情況編制許多不同的報(bào)表了，大大減輕了用戶的工作量。此外我們還可以利用宏來實(shí)現(xiàn)按一個(gè)數(shù)據(jù)集的任意字段查詢，這是利用參數(shù)所不能實(shí)現(xiàn)的。其中：填報(bào)屬性、數(shù)據(jù)集屬性中的參數(shù)值，這兩個(gè)地方目前不能用宏，其它地方的表達(dá)式都可以使用 屬性值不能用宏，宏只能用在表達(dá)式中 表達(dá)式中的引用方法為$宏名 宏不能寫在引號里面5.5 單元格任意選中一個(gè)單元格，在設(shè)計(jì)器的右邊就會出現(xiàn)該單元格的屬性列表，大家可以看到，每個(gè)屬性都有屬性值和表達(dá)式兩種，如下圖所示：這兩種有什么區(qū)別呢？ 首先，屬性值

18、和表達(dá)式是互斥的，定義了屬性值，就不必定義表達(dá)式，定義了表達(dá)式，就不必定義屬性值。其次，屬性值是在編輯報(bào)表時(shí)就寫死了的，在報(bào)表運(yùn)行時(shí)不必經(jīng)過運(yùn)算，也不會被改變。例如：你在單元格的背景色的屬性值中定義了紅色，那么報(bào)表運(yùn)行時(shí)，它就是紅色，不會被運(yùn)算，不會被改變。而屬性的表達(dá)式在報(bào)表運(yùn)行時(shí)，會被運(yùn)算，該屬性的最終屬性值取決于表達(dá)式的運(yùn)算結(jié)果值。例如：你在單元格的背景色的屬性的表達(dá)式中編輯條件表達(dá)式，則滿足不同的條件顯示不同的顏色。在屬性表達(dá)式中可以用“value（）”來指代當(dāng)前單元格的數(shù)據(jù)值。5.6 主格根格（報(bào)表首格）報(bào)表左上角的灰色單元格稱為報(bào)表首格，也稱為根格。它用于存儲描述整個(gè)報(bào)表的屬性。如

19、下圖所示：根格（報(bào)表首格）的書寫規(guī)則為：0這里要強(qiáng)調(diào)的是 0而不是0主格和附屬格單元格進(jìn)行擴(kuò)展的過程中，缺省情況下，相對于其右（下）邊的單元格而言，擴(kuò)展格是主動復(fù)制的，被稱為其它格（其右/下的格）的主格，而其右（下）的單元格是被動跟隨復(fù)制的，被稱為擴(kuò)展格的附屬格或子格。主格和附屬格是相對的概念，即某格是另一格的主格或附屬格，不存在單獨(dú)的主格和附屬格。從主格的定義中看，顯然只有擴(kuò)展格才能是其它格的主格！要注意的是，在缺省情況下，擴(kuò)展格左（上）的格并不是其附屬格，只有右（下）的格才是其附屬格。特別地，某個(gè)單元格的主格屬性可以人為被改變。6 常用函數(shù)系統(tǒng)提供各種類型的函數(shù)，下面就常用的函數(shù)進(jìn)行介紹；

20、其他函數(shù)可以通過系統(tǒng)提供的幫助來學(xué)習(xí)。6.1 數(shù)據(jù)集函數(shù)6.1.1 select()從數(shù)據(jù)集的當(dāng)前行集中選取符合條件的記錄， 例1：ds1.select( name ) 從數(shù)據(jù)源ds1中選取name字段列的所有值，不排序 例2：ds1.select( #2, true ) 從數(shù)據(jù)源ds1中選取第二個(gè)字段列的所有值并降序排列 例3：ds1.select( name,false,sex=1) 從數(shù)據(jù)源ds1中選取性別為男性(1)的name字段列的值并升序排列 例4：ds1.select( name, true, sex=1, id ) 從數(shù)據(jù)源ds1中選取性別為男性的name字段列的值并按id字段降序排列6.1.2 select1()從數(shù)據(jù)集中按順序檢索到符合過濾條件的第一條記錄，返回其selectExp值 例1：ds1.select1(name) 返回?cái)?shù)據(jù)集ds1中第一條記錄的name字段值 例2：ds1.select1(name,score90) 從數(shù)據(jù)集ds1中檢索出成績大于90的記錄，返回第一條記錄的name字段值6.1.3 count()計(jì)算數(shù)據(jù)集當(dāng)前記錄行集中，滿足條件的記錄數(shù)6.2 單元格函數(shù)6.2.1 if()例1：if(v