例程說明文檔

1、報(bào)表系統(tǒng)應(yīng)用例程說明文檔此文檔由北京亞控公司提供，僅作為KingSCADA3.0報(bào)表系統(tǒng)應(yīng)用的使用參考，其中涉及內(nèi)容的詳細(xì)說明請(qǐng)參考KingSCADA3.0的使用說明或咨詢技術(shù)支持工程師。“報(bào)表系統(tǒng)應(yīng)用例程”說明文檔目 錄1. 概述12. 例程12.1 實(shí)時(shí)報(bào)表12.2 歷史報(bào)表32.3 日?qǐng)?bào)表73. 注意事項(xiàng)11北京亞控科技發(fā)展有限公司 i1. 概述數(shù)據(jù)報(bào)表是生產(chǎn)過程中必不可少的一個(gè)部分，利用報(bào)表系統(tǒng)可對(duì)生產(chǎn)過程中產(chǎn)生的事件、報(bào)警、實(shí)時(shí)和歷史數(shù)據(jù)記錄并查詢，以一定格式輸出給用戶。它是反映生產(chǎn)過程中的數(shù)據(jù)、狀態(tài)等，并對(duì)數(shù)據(jù)進(jìn)行記錄的一種重要形式。KingSCADA3.0提供內(nèi)嵌式報(bào)表系統(tǒng)，工程

2、人員可以任意設(shè)置報(bào)表格式并通過系統(tǒng)提供的報(bào)表函數(shù)在報(bào)表中實(shí)現(xiàn)各種運(yùn)算、數(shù)據(jù)轉(zhuǎn)換、統(tǒng)計(jì)分析和打印等操作，在KingSCADA3.0系統(tǒng)中既可以實(shí)現(xiàn)實(shí)時(shí)數(shù)據(jù)報(bào)表，也可以實(shí)現(xiàn)歷史數(shù)據(jù)報(bào)表，同時(shí)還支持在線修改報(bào)表格式的功能。下面通過一個(gè)例程來介紹報(bào)表的各種功能。2. 例程2.1 實(shí)時(shí)報(bào)表在此例程中我們定義兩個(gè)變量，分別為temperature、pressure、flow。新建畫面，畫面名稱“Report”，在畫面上添加一報(bào)表控件，如圖1所示。圖1 報(bào)表窗口設(shè)置報(bào)表窗屬性：ShowRowTitle：設(shè)置為“false”，報(bào)表窗口中不顯示行號(hào)，如：1，2，3，4ShowColumnTitle：設(shè)置為“fa

3、lse”，報(bào)表窗口中不顯示列號(hào)，如：A，B，C，D如圖2所示。圖2 報(bào)表窗口屬性選中報(bào)表窗口 單擊鼠標(biāo)右鍵，在彈出的右鍵菜單中執(zhí)行“編輯”命令，彈出報(bào)表工具箱，如3所示：圖3報(bào)表工具箱單擊單元格格式菜單，設(shè)置報(bào)表單元格的背景色，字體等。單擊按鈕彈出變量選擇窗口，選擇要查詢實(shí)時(shí)數(shù)據(jù)的變量。在運(yùn)行環(huán)境中可以看到該變量的實(shí)時(shí)值，或者在某個(gè)單元格中直接輸入變量的名稱，輸入格式如：=localflow。報(bào)表設(shè)置完成后，如圖4所示。圖4 實(shí)時(shí)報(bào)表窗口2.2 歷史報(bào)表變量Temperature、Pressure、flow設(shè)置保存歷史數(shù)據(jù)，系統(tǒng)運(yùn)行后記錄歷史數(shù)據(jù)。第一步：添加報(bào)表窗在畫面“Report”上再添

4、加一個(gè)報(bào)表窗口，設(shè)置報(bào)表窗屬性。ShowRowTitle：設(shè)置為“false”，報(bào)表窗口中不顯示行號(hào)，如：1，2，3，4ShowColumnTitle：設(shè)置為“false”，報(bào)表窗口中不顯示列號(hào)，如：A，B，C，DHistoryTags：單擊該項(xiàng)，在彈出的變量選擇窗口中選擇要查詢歷史數(shù)據(jù)的變量Temperature、Pressure、flow。如圖5所示。圖5 報(bào)表窗屬性選中報(bào)表窗口 單擊鼠標(biāo)右鍵，在彈出的右鍵菜單中執(zhí)行“編輯”命令，通過報(bào)表工具箱，設(shè)置報(bào)表格式，如圖6所示。圖6 歷史報(bào)表窗口第二步：添加日期時(shí)間控件及文本在圖形編輯器中單擊“對(duì)象”菜單 Windows UI 日期時(shí)間控件，在畫

5、面上添加兩個(gè)日期時(shí)間控件“UIDateTime1”和“UIDateTime2”，其屬性設(shè)置，如圖7所示：圖7 日期時(shí)間控件屬性再添加文本“Text3”，模擬值輸入和模擬值輸出動(dòng)畫鏈接關(guān)聯(lián)變量localStepTime，如圖8所示。圖8 動(dòng)畫連接第三步：添加、設(shè)置按鈕1）查詢按鈕：打開圖庫精靈，在畫面上添加一按鈕，在按鈕上再添加文本為：查詢，該按鈕按下命令語言如下：long year1;long month1;long day1;long hour1;long minute1;long second1;long year2;long month2;long day2;long hour2;lon

6、g minute2;long second2;long StartTime;long EndTime;year1=UIDateTime1.Year;month1=UIDateTime1.Month;day1=UIDateTime1.Day;hour1=UIDateTime1.Hour;minute1=UIDateTime1.Minute;second1=UIDateTime1.Second;year2=UIDateTime2.Year;month2=UIDateTime2.Month;day2=UIDateTime2.Day;hour2=UIDateTime2.Hour;minute2=UID

7、ateTime2.Minute;second2=UIDateTime2.Second;string str=InfoAppDir()+Reportmodel.rtl;Report0.ReportLoad(str);Report0.SetCellString(2,4,local$Date); /填寫日期StartTime=ConvertTimeToSecond(year1,month1,day1,hour1,minute1,second1,0);EndTime=ConvertTimeToSecond(year2,month2,day2,hour2,minute2,second2,0);Repor

8、t0.SetTime(StartTime,EndTime,localStepTime);Report0.SetHistData(localtemperature,2); Report0.SetHistData(localpressure,3);Report0.SetHistData(localflow,4);Report0.Query();編輯完成后點(diǎn)擊“確認(rèn)”，完成查詢按鈕的設(shè)置。2）保存按鈕在畫面上添加保存按鈕，該按鈕按下命令語言如下：string filename1;string str1;str1=StrFromInt(local$Year, 10)+StrFromInt(local$

9、Month, 10)+StrFromInt(local$Day, 10)+StrFromInt(local$Hour, 10);filename1=InfoAppDir()+Report+str1+.csv;localfilename=InfoAppDir()+Report+str1+.rtl;Report0.ReportSaveAs(filename);Report0.ReportSaveAs(filename1);3）打印預(yù)覽按鈕在畫面上添加打印預(yù)覽按鈕，該按鈕按下命令語言如下：Report0.Preview();4）打印按鈕在畫面上添加打印按鈕，該按鈕按下命令語言如下：Report0.P

10、rint();5）SetTimes查詢按鈕在畫面上添加SetTimes查詢按鈕，該按鈕按下命令語言如下：Report0.SetTimes();Report0.Query();6）查詢關(guān)系數(shù)據(jù)庫按鈕在畫面上添加查詢關(guān)系數(shù)據(jù)庫按鈕，該按鈕按下命令語言如下：KDBGetDataset(MyDataset, DSN=data, select dateandtime,temperature,pressure,flow from data); Report0.SetDataset2(MyDataset,4,1);注：查詢關(guān)系數(shù)據(jù)庫之前先要建立ODBC數(shù)據(jù)源，然后在系統(tǒng)腳本應(yīng)用程序啟動(dòng)時(shí)和應(yīng)用程序關(guān)閉時(shí)連接

11、和斷開數(shù)據(jù)庫。2.3 日?qǐng)?bào)表第一步：制作報(bào)表畫面新建畫面，畫面名稱“DayReport”。在畫面上添加一報(bào)表控件，屬性設(shè)置與實(shí)時(shí)報(bào)表相同。 通過報(bào)表工具欄設(shè)置報(bào)表格式，如圖10所示。圖10 日?qǐng)?bào)表窗口第二步：創(chuàng)建日期時(shí)間控件在圖形編輯器中單擊“對(duì)象”菜單 Windows UI 日期時(shí)間控件，在畫面上添加日期時(shí)間控件，其屬性設(shè)置，如圖11所示：圖11 日期時(shí)間控件屬性第三步：創(chuàng)建組合框控件在圖形編輯器中單擊“對(duì)象”菜單 Windows UI 組合框控件，在畫面上添加組合框控件，在組合框控件的下拉列表選項(xiàng)改變時(shí)觸發(fā)事件OnSelectedIndexChange（）里寫如下腳本，如圖12所示。loc

12、alfilename=UIComboBox1.GetCurrentText();圖12 組合框控件腳本注意：開發(fā)過程當(dāng)中，往畫面上添加一個(gè)組合框時(shí)，要點(diǎn)擊一下它的下拉按鈕，使組合框的縱向擴(kuò)大，以避免運(yùn)行過程中下拉列表項(xiàng)不顯示的問題。第四步：添加、設(shè)置按鈕1）查詢按鈕在畫面上添加一按鈕，按鈕文本為：查詢，該按鈕按下命令語言如下：float y1;float m1;float d1;long StartTime;long EndTime;string dtime1;y1=UIDateTime1.Year;m1=UIDateTime1.Month;d1=UIDateTime1.Day;dtime1=

13、StrFromReal(y1,0,f)+-+StrFromReal(m1,0,f)+-+StrFromReal(d1,0,f);localselectdate=dtime1;Report0.SetCellString(2,4,dtime1); /填寫日期Report0.SetCellStrings(4,1,27,4,); /清空單元格StartTime=ConvertTimeToSecond(y1,m1,d1,0,0,0,0);EndTime=ConvertTimeToSecond(y1,m1,d1,23,59,59,0);Report0.SetTime(StartTime,EndTime,3

14、600000);Report0.SetHistData(localtemperature,2); Report0.SetHistData(localpressure,3);Report0.SetHistData(localflow,4);Report0.Query();編輯完成后點(diǎn)擊“確認(rèn)”，完成查詢按鈕的設(shè)置。2）保存按鈕在畫面上添加保存按鈕，該按鈕按下命令語言如下：string filename1;string str;int index1;str=InfoAppDir()+DayReport+list.csv;filename1=InfoAppDir()+DayReport+locals

15、electdate+.csv;localfilename=InfoAppDir()+DayReport+localselectdate+.rtl;Report0.ReportSaveAs(filename);Report0.ReportSaveAs(filename1);/更新列表框內(nèi)容，列表框內(nèi)顯示的是生成的所有報(bào)表文件localselectindex=UIComboBox1.GetFirstIndex(localselectdate,0);if (localselectindex!=0)UIComboBox1.DeleteItem(localselectindex);UIComboBox1.AddItem(localselectdate);UIComboBox1.ExportToFile(str);3）讀取報(bào)表按鈕在畫面上添加讀取報(bào)表按鈕，該按鈕按下命令語言如下：string filename1;filename1=InfoAppDir()+DayReport+local