紫金橋?qū)崟r(shí)數(shù)據(jù)庫(kù)二次開發(fā)包及手冊(cè)等歷史數(shù)據(jù)存儲(chǔ)

1、目錄概述1第一章第二章第三章第四章第五章第六章指定歷史. 2歷史插值4歷史保存參數(shù)5數(shù)據(jù)恢復(fù)功能6歷史數(shù)據(jù)檢索8標(biāo)準(zhǔn)統(tǒng)計(jì)數(shù)據(jù)9第七章 歷史數(shù)據(jù)控件11歷史數(shù)據(jù)控件11SPC數(shù)據(jù)控件16摘要數(shù)據(jù)對(duì)象22第八章 歷史數(shù)據(jù)相關(guān)控件和函數(shù)29與歷史數(shù)據(jù)有關(guān)的控件29歷史趨勢(shì)29趨勢(shì)分析30歷史報(bào)表304）報(bào)表33開始時(shí)間34時(shí)間長(zhǎng)度342與歷史數(shù)據(jù)有關(guān)的函數(shù)341）函數(shù)342）API接口352）控件接口36第 1 頁大慶紫金橋：技術(shù)辦事處傳真：第一章 概述是實(shí)時(shí)數(shù)據(jù)庫(kù)的功能之一。在工業(yè)控制中，常常要從一些數(shù)據(jù)的歷史趨勢(shì)中分析問題和發(fā)現(xiàn)問題，保存歷史數(shù)據(jù)就顯得十分重要。支持歷史數(shù)據(jù)的快速保存和檢索，它按

2、照一定的條件把數(shù)據(jù)保存到歷史庫(kù)中，用戶需要時(shí)可隨時(shí)從歷史數(shù)據(jù)庫(kù)中歷史數(shù)據(jù)。歷史數(shù)據(jù)一般是點(diǎn)的某個(gè)參數(shù)在過去某一時(shí)刻的瞬時(shí)值，是與時(shí)間有關(guān)的數(shù)據(jù)，每一個(gè)歷史數(shù)據(jù)上都有一個(gè)時(shí)間戳，歷史數(shù)據(jù)的采樣時(shí)間。位號(hào)是否保存歷史數(shù)據(jù)，歷史數(shù)據(jù)的保存條件都由用戶進(jìn)行數(shù)據(jù)組態(tài)時(shí)決定。實(shí)時(shí)數(shù)據(jù)庫(kù)按照用戶指定的采樣條件在庫(kù)中進(jìn)行采樣，如果采樣的條件滿足，就將采樣數(shù)據(jù)加上時(shí)間戳，記入歷史庫(kù)中。歷史數(shù)據(jù)庫(kù)是磁盤文件，為了防止頻繁的寫磁盤，在內(nèi)存中開辟了歷史數(shù)據(jù)緩沖區(qū)。歷史數(shù)據(jù)從實(shí)時(shí)數(shù)據(jù)庫(kù)中以后，首先放在內(nèi)存緩沖區(qū)中，當(dāng)存盤時(shí)間到達(dá)或緩沖區(qū)已滿時(shí)的寫入磁盤歷史庫(kù)文件。用戶歷史數(shù)據(jù)時(shí)，系統(tǒng)首先檢查歷史數(shù)據(jù)緩沖區(qū)中是否有用戶需

3、要的歷史數(shù)據(jù)，如果沒有然后在檢查歷史數(shù)據(jù)庫(kù)文件中是否有用戶需要的歷史數(shù)據(jù)。歷史數(shù)據(jù)緩沖區(qū)的設(shè)立大大加快了歷史數(shù)據(jù)的存取速度。紫金橋歷史數(shù)據(jù)庫(kù)具有如下特點(diǎn)：能夠?qū)⑷魏吸c(diǎn)的任何參數(shù)存盤。無論數(shù)據(jù)來源于現(xiàn)場(chǎng)設(shè)備、人工錄入數(shù)據(jù)、還是計(jì)算結(jié)果都能存入歷史數(shù)據(jù)庫(kù)。具有先進(jìn)的數(shù)據(jù)壓縮算法，能夠充分利用有限的盤空間具有歷史插值功能。長(zhǎng)期的歷史數(shù)據(jù)另外提供了豐富的歷史數(shù)據(jù)統(tǒng)計(jì)工具，幫助用戶進(jìn)行各種數(shù)據(jù)分析。下面介紹、檢索、顯示方法，以及與歷史數(shù)據(jù)相關(guān)的控件。第 1 頁大慶紫金橋：技術(shù)辦事處傳真：第二章 指定歷史在缺省情況下不對(duì)點(diǎn)的任何參數(shù)進(jìn)行歷史。要想保存歷史，在點(diǎn)組態(tài)框中選擇歷史組態(tài)頁，如下所示：在上面框中，

4、選中“保存歷史”復(fù)選框，并選擇歷史保存策略。除了能對(duì) PV 值保存歷史外，您還可以對(duì)其他參數(shù)保存歷史。單擊“其他可以保存歷史的參數(shù)。參數(shù)”將列出歷史保存方式根據(jù)實(shí)際情況，需要不同的歷史保存方式，的歷史保存方式有兩種，定時(shí)保存和變化保存。定時(shí)保存最簡(jiǎn)單的保存方式是“定時(shí)保存”，即不管數(shù)據(jù)變化與否，周期性的將實(shí)時(shí)數(shù)據(jù)保存下來。如果周期較小，數(shù)據(jù)變化小于保存周期的情況，會(huì)造成一定的浪費(fèi)，因?yàn)榻?jīng)常保存的是重復(fù)的數(shù)值。當(dāng)然有時(shí)只想要準(zhǔn)確某些時(shí)刻的數(shù)據(jù)，如正點(diǎn)時(shí)數(shù)值，而不關(guān)心期間的變化過程，可以選擇周期。如果您指定保存周期是 1 分鐘，那么只有時(shí)間為正好是整分鐘，如 8：00：00，8：01：00 時(shí)才會(huì)

5、進(jìn)行數(shù)據(jù)。同樣如果指定保存周期是 1 小時(shí)，那么只有在整點(diǎn)時(shí)才會(huì)保存歷史數(shù)據(jù)。但是如果是歷史插值，那么將不能保證數(shù)據(jù)是時(shí)間對(duì)齊的。變化保存數(shù)據(jù)只有變化了，并且變化超出了一定范圍時(shí)才保存。如果數(shù)據(jù)在很小的范圍內(nèi)波動(dòng)（允許的誤差之內(nèi)）并不對(duì)其進(jìn)行歷史，因?yàn)閿?shù)值的微小變化對(duì)數(shù)據(jù)分析往往是沒有實(shí)際意義的，而將這些數(shù)據(jù)全部保存將會(huì)浪費(fèi)大量的盤空間。變化保存克服了周期保存的缺點(diǎn)，但是帶來了一定的精度損失。下面是一段時(shí)間內(nèi)數(shù)據(jù)的變化過程：第 2 頁X 軸是時(shí)間，Y:軸是數(shù)值大小。在圖中 A 到 B 區(qū)間，數(shù)據(jù)變化在兩條蘭線所表示的狹小區(qū)域之內(nèi)，如果只下A,B 兩個(gè)端點(diǎn),期間任何一點(diǎn)的數(shù)據(jù)可由時(shí)間在A 與B

6、間直線的交叉點(diǎn)對(duì)應(yīng)的Y 坐標(biāo)近似得到。如圖中紅線所示。在上面的圖形中，出數(shù)據(jù)的變化規(guī)律?？梢灾籄、B、C、D、E、F 幾處數(shù)據(jù)，就能較全面的表示通過調(diào)整精度參數(shù)，可以控制誤差大小。精度值越小，直線就越能反映真實(shí)情況。確省精度值為 1，表示最大的誤差是數(shù)值的。第 3 頁大慶紫金橋：技術(shù)辦事處傳真：第三章 歷史插值一般是將當(dāng)前的數(shù)值保存到歷史庫(kù)中，歷史插值功能允許您將過去的數(shù)到歷史庫(kù)中。該功能特別適合于具有歷史的 I/O 設(shè)備，據(jù)，如昨天的數(shù)據(jù)能表支持歷史些智功能，當(dāng)其發(fā)現(xiàn)與上位機(jī)（機(jī)）通信中斷時(shí)，能夠?qū)嗑€期間的數(shù)據(jù)保存起來，當(dāng)恢復(fù)通信后，可以將保存在緩存的數(shù)據(jù)轉(zhuǎn)儲(chǔ)到上位機(jī)中。對(duì)于具有歷史功能的

7、 I/O 設(shè)備，紫金橋驅(qū)動(dòng)程序不但能夠?qū)崟r(shí)數(shù)據(jù)，同時(shí)也能夠從設(shè)備歷史數(shù)據(jù)，并將歷史數(shù)據(jù)到實(shí)時(shí)數(shù)據(jù)庫(kù)中。除了設(shè)備驅(qū)動(dòng)能夠向?qū)崟r(shí)數(shù)據(jù)庫(kù)歷史數(shù)據(jù)外，您也可以通過數(shù)據(jù)庫(kù)、畫面、調(diào)用 API 接口、COM 控件來完成。參見后面的歷史數(shù)據(jù)相關(guān)控件、函數(shù)。第 4 頁第四章 歷史保存參數(shù)有兩個(gè)與歷史相關(guān)的系統(tǒng)參數(shù)：保存天數(shù)和歷史數(shù)據(jù)塊大小。單擊導(dǎo)航樹“數(shù)據(jù)庫(kù)/數(shù)據(jù)庫(kù)設(shè)置/系統(tǒng)參數(shù)”，將出現(xiàn)如下所示框：保存天數(shù)：即歷史數(shù)據(jù)保存的最大天數(shù)。超過該天數(shù)的歷史數(shù)據(jù)將被刪除，以便節(jié)省盤空間。數(shù)據(jù)塊大?。喝笔?600 字節(jié)，該大小適合于保存數(shù)據(jù)變化周期為 250 毫秒的實(shí)時(shí)數(shù)據(jù)，如果數(shù)據(jù)變化很快，可以適當(dāng)加大該參數(shù)，注

8、意加大一倍保存空間加大兩倍，這樣 1200 就適合于數(shù)據(jù)變化周期為 60 毫秒的數(shù)據(jù)了。當(dāng)然如果數(shù)據(jù)變化較慢，也可以減小該參數(shù)，如數(shù)據(jù)變化周期為 1000 毫秒，可以指定塊大小為 300。第 5 頁大慶紫金橋：技術(shù)辦事處傳真：第五章 數(shù)據(jù)恢復(fù)功能數(shù)據(jù)庫(kù)間進(jìn)行通訊時(shí)，如果網(wǎng)絡(luò)出現(xiàn)故障，或者數(shù)據(jù)庫(kù)退出后重新啟動(dòng)，服務(wù)端能夠暫存斷線期間的歷史數(shù)據(jù)，并將之自動(dòng)恢復(fù)到客戶端。數(shù)據(jù)恢復(fù)的設(shè)定在缺省情況下，該功能被（在數(shù)據(jù)請(qǐng)求方定義）。要啟動(dòng)該功能，要在數(shù)據(jù)源定義中進(jìn)行如下設(shè)置。單擊高級(jí)選項(xiàng)按鈕，出現(xiàn)如下框：1）故障數(shù)據(jù)恢復(fù)：選中“故障數(shù)據(jù)恢復(fù)”復(fù)選框。在數(shù)據(jù)恢復(fù)時(shí)間中輸入服務(wù)器斷線期間數(shù)據(jù)的最長(zhǎng)時(shí)間。超過

9、該時(shí)限，服務(wù)器將放棄保存的數(shù)據(jù)。這樣可以避免服務(wù)器因故障時(shí)間過長(zhǎng)而保存大量的數(shù)據(jù)。第 6 頁注意：該值過大可能造成系統(tǒng)較大開銷，如果數(shù)據(jù)庫(kù)間連接的點(diǎn)數(shù)較多，且數(shù)據(jù)變化速度較快，該值不要過大。2）更新方式更新方式有兩種，變化通知和周期查詢。變化通知即將所有的數(shù)據(jù)變化都通知給客戶；而周期查詢是按照周期中指定的時(shí)間進(jìn)行查詢。周期查詢的缺點(diǎn)是，客戶的不到一個(gè)查詢周期內(nèi)的數(shù)值連續(xù)變化過程。 變化通知的缺點(diǎn)是可能數(shù)據(jù)變化太快，造成通信開銷過大。在斷線情況下，兩種方式的數(shù)據(jù)恢復(fù)處理是有差別的。在變化通知方式下，服務(wù)器會(huì)將所有數(shù)據(jù)變化都保存下來，而周期查詢是按照指定的周期保存數(shù)據(jù)。對(duì)于數(shù)據(jù)量大（歷史的點(diǎn)較多，

10、不保存歷史的點(diǎn)不計(jì)）、且變化速度較快的情況，建議使用周期查詢方式；反之可以使用變化通知方式。3）超時(shí)時(shí)間對(duì)服務(wù)器的請(qǐng)求可能由于網(wǎng)絡(luò)傳輸?shù)脑?，客戶端?qǐng)求的數(shù)據(jù)和服務(wù)器端應(yīng)答的數(shù)據(jù)能確保數(shù)據(jù)一定每次都能準(zhǔn)確及時(shí)傳輸。這時(shí)可以設(shè)定一個(gè)時(shí)間范圍，如果大于該時(shí)間范圍沒有返回，則認(rèn)為當(dāng)前的請(qǐng)求已經(jīng)無效。這個(gè)時(shí)間設(shè)定應(yīng)該在一個(gè)合理的范圍之內(nèi)，一般的，網(wǎng)絡(luò)傳輸速度較快，時(shí)間可以較短如 3 秒，而串口和撥號(hào)方式相對(duì)時(shí)間要長(zhǎng)一些如 30秒。時(shí)間太長(zhǎng)或太短，都會(huì)導(dǎo)致刷新速度較慢。服務(wù)器只有檢測(cè)到客戶斷線時(shí)間超出該值之后，才為其保存數(shù)據(jù)，以待恢復(fù)。服務(wù)器的保護(hù)因?yàn)榭蛻艨赡荛L(zhǎng)期處于停止?fàn)顟B(tài)，所以服務(wù)器不可能無休止的為

11、客戶保存故障期間的數(shù)據(jù)。為了避免服務(wù)器數(shù)據(jù)量過大，一是可以減小客戶端中故障恢復(fù)時(shí)限，二是在服務(wù)器數(shù)據(jù)庫(kù)系統(tǒng)參數(shù)中指定“數(shù)據(jù)恢復(fù)文件的最大容量”，見下圖所示：第 7 頁大慶紫金橋：技術(shù)辦事處傳真：第六章 歷史數(shù)據(jù)檢索無論是周期，還是變化保存，也不管保存周期是多大，都可以用同樣的方法檢可以以 1 秒為采樣周期，取歷史數(shù)據(jù)。例如保存的方式是 “周期”，周期為 60 秒，也可以用 1 小時(shí)為采樣周期檢索歷史數(shù)據(jù)，歷史庫(kù)會(huì)幫您找到最相近時(shí)刻的數(shù)據(jù)。歷史數(shù)據(jù)庫(kù)提供了豐富的檢索方式，來幫助您進(jìn)行歷史數(shù)據(jù)分析。下面對(duì)各種方式予以說明：周期采樣以固定周期查詢過去某一時(shí)段的歷史數(shù)據(jù)，如以 1 分鐘為采樣周期，查詢

12、前 1 小時(shí)的歷史數(shù)據(jù)。數(shù)據(jù)類型分為瞬時(shí)值、平均值、最大/最小值三種。瞬時(shí)值即采樣時(shí)刻的值。一般情況下，歷史庫(kù)不會(huì)恰巧在采樣時(shí)刻保存數(shù)據(jù)，這時(shí)歷史庫(kù)會(huì)給出是與采樣時(shí)刻最接近時(shí)間的數(shù)據(jù)，一般為與采樣點(diǎn)最所示：的上一時(shí)刻保存的數(shù)據(jù)。如下圖圖中曲線上的小矩形代表一段時(shí)間內(nèi)歷史數(shù)據(jù)保存點(diǎn)。t 表示要檢取的采樣點(diǎn)，a,b分別表示位于采樣點(diǎn)前一時(shí)刻與后一時(shí)刻的歷史數(shù)據(jù)保存點(diǎn)。如果 a 與b 間沒有進(jìn)行數(shù)據(jù)壓縮處理，那么 t 時(shí)刻的值將采用 a 時(shí)刻的歷史值。如果進(jìn)行了壓縮處理，則 t 時(shí)刻的值將 a,b兩點(diǎn)的值計(jì)算得到，公式如下：Vt = Va + (Vb Va) /(Tb- Ta) * (Tt Ta)在

13、上面公式中 Vt,Va,Vb 分別表示在時(shí)間點(diǎn) t，a,b 時(shí)刻的數(shù)值Tt,b 則分別表示在時(shí)間點(diǎn) t，a，b 時(shí)刻的時(shí)間。平均值即采樣周期內(nèi)的平均值。例如采樣周期為 1 分鐘，那么每個(gè)采樣值就是分鐘平均值。最大/最小值即采樣周期內(nèi)的最大和最小值。例如采樣周期為 1 分鐘，那么采樣值就是分鐘內(nèi)的最大值和最小值。第 8 頁所有數(shù)據(jù)得到某一時(shí)段內(nèi)的歷史庫(kù)中保存的所有數(shù)據(jù)。邊界查詢得到某一時(shí)段內(nèi)偏離指定數(shù)值的時(shí)間點(diǎn)。例如得到前 60 分鐘內(nèi)，數(shù)值剛好超過 90 和小于 10 的臨界點(diǎn)。如下圖所示：圖中的大于 10 和小于 90 的邊界數(shù)據(jù)如紅圈所示。統(tǒng)計(jì)數(shù)據(jù)歷史數(shù)據(jù)庫(kù)能夠?qū)θ我粫r(shí)段的歷史數(shù)據(jù)進(jìn)行統(tǒng)計(jì)

14、，如對(duì)歷史數(shù)據(jù)可以進(jìn)行小時(shí)統(tǒng)計(jì)、也可以進(jìn)行分鐘統(tǒng)計(jì)。統(tǒng)計(jì)內(nèi)容包括：平均值、最大值、最小值、方差值。統(tǒng)計(jì)數(shù)據(jù)可以通過函數(shù)、API 接口、歷史數(shù)據(jù)控件得到。標(biāo)準(zhǔn)統(tǒng)計(jì)數(shù)據(jù)標(biāo)準(zhǔn)統(tǒng)計(jì)數(shù)據(jù)也稱作摘要信息。標(biāo)準(zhǔn)統(tǒng)計(jì)數(shù)據(jù)的最小時(shí)間是小時(shí)。統(tǒng)計(jì)內(nèi)容包括：平均值、最大值、最小值。統(tǒng)計(jì)數(shù)據(jù)是數(shù)據(jù)庫(kù)根據(jù)實(shí)時(shí)值實(shí)時(shí)計(jì)算得出的，所以比從歷史數(shù)據(jù)計(jì)算得出的值要準(zhǔn)確。利用統(tǒng)計(jì)數(shù)據(jù)可以進(jìn)行小時(shí)統(tǒng)計(jì)、班統(tǒng)計(jì)、日統(tǒng)計(jì)、月統(tǒng)計(jì)、年統(tǒng)計(jì)。標(biāo)準(zhǔn)統(tǒng)計(jì)數(shù)據(jù)只是針對(duì)點(diǎn)的 PV 值進(jìn)行統(tǒng)計(jì)，如果要對(duì)其他參數(shù)進(jìn)行統(tǒng)計(jì)，可以將參數(shù)通過 連接，連接到其他點(diǎn)的 PV 值上，然后對(duì)被連接點(diǎn)的 PV 值進(jìn)行統(tǒng)計(jì)即可。統(tǒng)計(jì)的指定在點(diǎn)的基本屬性頁中（只有模擬量

15、類型的點(diǎn)有該選項(xiàng)），選中是否統(tǒng)計(jì)復(fù)選框即可，如下圖所示：第 9 頁大慶紫金橋：技術(shù)辦事處傳真：SIS 參數(shù)SIS 是統(tǒng)計(jì)標(biāo)志，該參數(shù)為 1，表示對(duì) PV 值進(jìn)行統(tǒng)計(jì)，為 0 表示不進(jìn)行統(tǒng)計(jì)。對(duì)于自定義點(diǎn)類型，如果需要統(tǒng)計(jì)功能，必須選擇統(tǒng)計(jì)標(biāo)志參數(shù) S獲取統(tǒng)計(jì)數(shù)據(jù)IS。統(tǒng)計(jì)數(shù)據(jù)可以通過函數(shù)、API 接口、摘要數(shù)據(jù)控件得到。第 10 頁第七章 歷史數(shù)據(jù)控件1歷史數(shù)據(jù)控件歷史數(shù)據(jù)是為了查詢歷史數(shù)據(jù)用的，該表一般不單獨(dú)使用，而是配合表格或歷史報(bào)表使用的。通過歷史數(shù)據(jù)控件可以得到某一位號(hào)在過去某一時(shí)刻的數(shù)值。 歷史數(shù)據(jù)控件可以同時(shí)對(duì)多個(gè)位號(hào)，多個(gè)時(shí)刻的數(shù)據(jù)進(jìn)行檢索。使用步驟1） 在組態(tài)環(huán)境中添加歷史數(shù)據(jù)

16、控件。2） 通過其屬性框指定要查詢的位號(hào)，也可以通過該控件數(shù))。動(dòng)態(tài)增加位號(hào)(AddTag 函3） 在中調(diào)用歷史數(shù)據(jù)控件的函數(shù)，啟動(dòng)查詢(調(diào)用 Start 函數(shù))。通過狀態(tài)函數(shù) IsReady 檢測(cè)檢索是否完成。通過 GetGetTextGetCellGetCellText 等函數(shù)得到歷史數(shù)據(jù)中的數(shù)據(jù)。這些數(shù)據(jù)可以用于報(bào)表顯示。添加控件歷史數(shù)據(jù)控件是一圖形對(duì)象，可以通過子圖選擇框添加到窗口中。在窗口中雙擊歷史數(shù)據(jù)控件將出現(xiàn)如下屬性框：第 11 頁大慶紫金橋：技術(shù)辦事處傳真：在框中輸入要查詢歷史數(shù)據(jù)的位號(hào)名，操作步驟如下：1） 選擇數(shù)據(jù)源，在下拉框中選擇要的數(shù)據(jù)源。小數(shù)位數(shù)：輸入要顯示的小數(shù)位數(shù)

17、。數(shù)據(jù)類型：可以是時(shí)間間隔內(nèi)（由 Start 函數(shù)指定）的瞬時(shí)值或平均值。增加：在位號(hào)輸入框：輸入位號(hào)，或通過位號(hào)選擇按鈕選取位號(hào)。單擊“增加”按鈕，將位號(hào)加入到左面位號(hào)列表。刪除：?jiǎn)螕簟皠h除”按鈕，將位號(hào)從左面位號(hào)列表中刪除。修改：在左面位號(hào)列表中選擇好要修改的位號(hào)，在位號(hào)輸入框中輸入修改內(nèi)容，單擊“修改”按鈕。運(yùn)行時(shí)可見：選中該復(fù)選框，運(yùn)行時(shí)將顯示歷史數(shù)據(jù)（這樣可以調(diào)試），一般情況下，不用選擇該復(fù)選框。8） 單擊“”按鈕將出現(xiàn)定義框：在定義框中可以指定控件進(jìn)入時(shí)動(dòng)作，以及數(shù)據(jù)檢索完成時(shí)動(dòng)作。函數(shù)說明：Start(Beg說明ime, Cycle, Count)開始檢索，通過函數(shù) IsRead

18、y 來檢測(cè)檢索是否完成。參數(shù)Begime ： 整型，開始時(shí)間，該時(shí)間為從 1970 年 1 月 1 日零時(shí)過去的秒數(shù)。Cycle：周期，即同一位號(hào)每個(gè)數(shù)據(jù)之間的間隔時(shí)間。 Count：每個(gè)位號(hào)要取的數(shù)據(jù)個(gè)數(shù)?？偟臅r(shí)間長(zhǎng)度為 Cycle * Count。為秒。第 12 頁示例：#HisData.Start(LongTime(2001/01/01 14:50:48), 60, 10);/#HisData.為控件名稱。AddTag(TagName, Decimal, IsAverage)說明添加位號(hào)。參數(shù)TagName：位號(hào)名稱，字符串類型。 Decimal： 整型，小數(shù)位數(shù)，0 表示無小數(shù)。 Is

19、Average：是否為平均值。示例：#HisData. AddTag (“A1.PV”, 2, 0);/#HisData.為控件名稱。ClearAllTag ()說明刪除所有位號(hào)。參數(shù)無。示例：#HisData. ClearAllTag ();/#HisData.為控件名稱。Get (TagName, Index)說明得到指定位號(hào)的數(shù)值。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #HisData.Get (“TI1001.PV”, 0);/ Val 為實(shí)型

20、變量。GetText (TagName, Index)說明得到指定位號(hào)的字符串。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。示例：Str = #HisData.GetText (“TI1001.PV”, 0);第 13 頁大慶紫金橋：技術(shù)辦事處傳真：/Str 為字符串型變量。GetCell(Row,Col)說明得到指定單元格的數(shù)值?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定

21、的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #HisData.GetCell(0, 0);/ Val 為實(shí)型變量。GetCellText(Row,Col)說明得到指定單元格的文本?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。示例：Str = #HisData.GetCellText(0, 0);/Str 為字符串型變量。GetTagName(

22、TagIndex)說明得到指定序號(hào)的位號(hào)名稱。參數(shù)TagIndex：位號(hào)序號(hào)。序號(hào)從 0 開始。返回值：返回指定序號(hào)的位號(hào)名稱，類型為字符串。示例：Str = #HisData. GetTagName (0);/Str 為字符串型變量。GetTimeText (DataIndex，F(xiàn)ormat)說明得到指定數(shù)據(jù)序號(hào)的時(shí)間字符串。參數(shù)DataIndex：數(shù)據(jù)序號(hào)。序號(hào)從 0 開始。Format：時(shí)間格式。 0：YYYY/MM/DD hh:mm:ss 1：YYYY/MM/DD2：hh:mm:ss第 14 頁3：YYYY/MM/DD hh:mm4：YYYY/MM/DD hh 5：MM/DD hh:m

23、m其中 YYYY：表示年； MM：表示月； DD：表示日； hh：表示時(shí)； mm：表示分；ss：表示秒；返回值：返回指定數(shù)據(jù)序號(hào)的時(shí)間，類型為字符串。示例：Str = #HisData.GetTimeText (0，0);/Str 為字符串型變量。IsReady()說明檢測(cè)檢索是否完成。參數(shù)返回值：為整型數(shù)。1：完成；0：未完成。示例：IF(#HisData.IsReady () THEN/得到數(shù)據(jù)。 ENDIFGetColCount（）說明得到列數(shù)，即位號(hào)個(gè)數(shù)。參數(shù)返回值：列數(shù)，為整型數(shù)。示例：TagCount = #HisData.GetRowCount();GetRowCount（）說明

24、得到行數(shù)，即數(shù)據(jù)個(gè)數(shù)。參數(shù)返回值：行數(shù)，為整型數(shù)。示例：Dount = #HisData.GetRowCount();第 15 頁大慶紫金橋：技術(shù)辦事處傳真：2SPC 數(shù)據(jù)控件SPC 數(shù)據(jù)是為了查詢 SPC 數(shù)據(jù)用的，該表一般不單獨(dú)使用，而是配合表格或歷史報(bào)表使用的。SPC 數(shù)據(jù)指的是一段時(shí)間內(nèi)位號(hào)的最大值、最小值、平均值、方差值。SPC 數(shù)據(jù)能夠反映數(shù)據(jù)的穩(wěn)定性。通過 SPC 數(shù)據(jù)控件可以得到某一位號(hào)在過去某時(shí)段的統(tǒng)計(jì)信息。SPC 數(shù)據(jù)控件可以同時(shí)對(duì)多個(gè)位號(hào)，多個(gè)連續(xù)時(shí)段的數(shù)據(jù)進(jìn)行統(tǒng)計(jì)。使用步驟6） 在組態(tài)環(huán)境中添加 SPC 數(shù)據(jù)控件。7） 通過其屬性框指定要查詢的位號(hào)，也可以通過該控件數(shù))

25、。動(dòng)態(tài)增加位號(hào)(AddTag 函8） 在中調(diào)用 SPC 數(shù)據(jù)控件的函數(shù)，啟動(dòng)查詢(調(diào)用 Start 函數(shù))。9） 通過“ 檢索完成時(shí)”或周期調(diào)用狀態(tài)函數(shù) IsReady 來檢查檢索是否完成。10）通過GetAverGetMinGetMaxGetDevGetCellGetCellText 等函數(shù)得到SPC 數(shù)據(jù)控件中的數(shù)據(jù)。這些數(shù)據(jù)可以用于報(bào)表顯示。添加控件SPC 數(shù)據(jù)控件是一圖形對(duì)象，可以通過子圖選擇框添加到窗口中。在窗口中雙擊 SPC 數(shù)據(jù)控件將出現(xiàn)如下屬性框：在框中輸入要查詢 SPC 數(shù)據(jù)的位號(hào)名，操作步驟如下：9） 選擇數(shù)據(jù)源，在下拉框中選擇要的數(shù)據(jù)源。小數(shù)位數(shù)：輸入要顯示的小數(shù)位數(shù)。忽

26、略壞值：選中該項(xiàng)，將剔除超過量程范圍的數(shù)據(jù)。第 16 頁增加：在位號(hào)輸入框：輸入位號(hào)，或通過位號(hào)選擇按鈕選取位號(hào)。單擊“增加”按鈕，將位號(hào)加入到左面位號(hào)列表。刪除：?jiǎn)螕簟皠h除”按鈕，將位號(hào)從左面位號(hào)列表中刪除。修改：在左面位號(hào)列表中選擇好要修改的位號(hào)，在位號(hào)輸入框中輸入修改內(nèi)容，單擊“修改”按鈕。運(yùn)行時(shí)可見：選中該復(fù)選框，運(yùn)行時(shí)將顯示 SPC 數(shù)據(jù)（這樣可以調(diào)試），一般情況下，不用選擇該復(fù)選框。16）單擊“”按鈕將出現(xiàn)定義框：在定義框中可以指定控件進(jìn)入時(shí)動(dòng)作，以及數(shù)據(jù)檢索完成時(shí)動(dòng)作。函數(shù)說明：Start(Beg說明ime, Cycle, Count)開始檢索，通過函數(shù) IsReady 來檢測(cè)檢

27、索是否完成。參數(shù)Begime ： 整型，開始時(shí)間，該時(shí)間為從 1970 年 1 月 1 日零時(shí)過去的秒數(shù)。Cycle：周期，即同一位號(hào)每個(gè)數(shù)據(jù)之間的間隔時(shí)間。 Count：每個(gè)位號(hào)要取的數(shù)據(jù)個(gè)數(shù)?？偟臅r(shí)間長(zhǎng)度為 Cycle * Count。示例：#SpcCtrl.Start(LongTime(2001/01/01 14:50:48), 60, 10);/#SpcCtrl.為 SPC 控件名稱。為秒。第 17 頁大慶紫金橋：技術(shù)辦事處傳真：AddTag(TagName, Decimal, IsAverage)說明添加位號(hào)。參數(shù)TagName：位號(hào)名稱，字符串類型。 Decimal： 整型，小數(shù)位

28、數(shù)，0 表示無小數(shù)。 IsAverage：是否為平均值。示例：#SpcCtrl. AddTag (“A1.PV”, 2, 0);/#SpcCtrl.為控件名稱。ClearAllTag ()說明刪除所有位號(hào)。參數(shù)無。示例：#SpcCtrl. ClearAllTag ();/#SpcCtrl.為控件名稱。GetAver (TagName, Index)說明得到指定位號(hào)的平均值。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #SpcCtrl.GetAver(“TI1

29、001.PV”, 0);/ Val 為實(shí)型變量。GetMax (TagName, Index)說明得到指定位號(hào)的最大值。參數(shù)及示例與 GetAver 類似，參見 GetAvert。GetMin (TagName, Index)說明得到指定位號(hào)的最小值。參數(shù)及示例與 GetAver 類似，參見 GetAvert。GetDev (TagName, Index)說明得到指定位號(hào)的方差值。第 18 頁參數(shù)及示例與 GetAver 類似，參見 GetAvert。GetAverText (TagName, Index)說明得到指定位號(hào)的平均值字符串。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型

30、，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。示例：Str = #SpcCtrl.GetAverText (“TI1001.PV”, 0);/Str 為字符串型變量。GetMaxText (TagName, Index)說明得到指定位號(hào)的最大值字符串。參數(shù)及示例與 GetAverText 類似，參見 GetAverText。GetM說明ext (TagName, Index)得到指定位號(hào)的最小值字符串。參數(shù)及示例與 GetAverText 類似，參見 GetAverText。GetDevText (TagName, Inde

31、x)說明得到指定位號(hào)的方差字符串。參數(shù)及示例與 GetAverText 類似，參見 GetAverText。GetCell(Row,Col, Type)說明得到指定單元格的數(shù)值?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。 Type：整型，值類型，0：平均；1：最小；2：最大；3：方差。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #SpcCtrl.GetCell(0, 0,0);/ Val 為實(shí)型變量。GetCellText(Row,Co

32、l, Type)說明得到指定單元格的文本?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。第 19 頁大慶紫金橋：技術(shù)辦事處傳真：參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。 Type：整型，值類型，0：平均；1：最小；2：最大；3：方差。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。示例：Str = #SpcCtrl.GetCellText(0, 0, 0);/Str 為字符串型變量。GetTagName(TagIndex)說明得到指定序號(hào)的位號(hào)名稱。參數(shù)TagIndex：位號(hào)序號(hào)。序號(hào)從 0

33、開始。返回值：返回指定序號(hào)的位號(hào)名稱，類型為字符串。示例：Str = #SpcCtrl. GetTagName (0);/Str 為字符串型變量。GetTimeText (DataIndex，F(xiàn)ormat)說明得到指定數(shù)據(jù)序號(hào)的時(shí)間字符串。參數(shù)DataIndex：數(shù)據(jù)序號(hào)。序號(hào)從 0 開始。Format：時(shí)間格式。 0：YYYY/MM/DD hh:mm:ss 1：YYYY/MM/DD2：hh:mm:ss 3：YYYY/MM/DD hh:mm4：YYYY/MM/DD hh 5：MM/DD hh:mm其中 YYYY：表示年； MM：表示月； DD：表示日； hh：表示時(shí)； mm：表示分；ss：表示

34、秒；返回值：返回指定數(shù)據(jù)序號(hào)的時(shí)間，類型為字符串。示例：Str = #SpcCtrl.GetTimeText (0，0);/Str 為字符串型變量。第 20 頁GetM說明imeText (TagName, Index)得到指定位號(hào)在指定周期內(nèi)達(dá)到最小值的時(shí)間。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)在指定周期達(dá)到最小值的時(shí)間，類型為字符串。示例：Str = #SpcCtrl. GetM/Str 為字符串型變量。imeText (“TI1001.PV”, 0);GetMaxTimeText (T

35、agName, Index)說明得到指定位號(hào)在指定周期內(nèi)達(dá)到最大值的時(shí)間。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)在指定周期達(dá)到最大值的時(shí)間，類型為字符串。示例：Str = #SpcCtrl. GetMaxTimeText (“TI1001.PV”, 0);/Str 為字符串型變量。IsReady()說明檢測(cè)檢索是否完成。參數(shù)返回值：為整型數(shù)。1：完成；0：未完成。示例：IF(#SpcCtrl.IsReady () THEN/得到數(shù)據(jù)。 ENDIFGetColCount（）說明得到列數(shù)，即位號(hào)個(gè)

36、數(shù)。參數(shù)返回值：列數(shù)，為整型數(shù)。示例：TagCount = #SpcCtrl.GetRowCount();GetRowCount（）說明第 21 頁大慶紫金橋：技術(shù)辦事處傳真：得到行數(shù)，即數(shù)據(jù)個(gè)數(shù)。參數(shù)返回值：行數(shù)，為整型數(shù)。示例：Dount = #SpcCtrl.GetRowCount();3摘要數(shù)據(jù)對(duì)象摘要數(shù)據(jù)是為了查詢摘要數(shù)據(jù)用的，該表一般不單獨(dú)使用，而是配合表格或歷史報(bào)表使用的。摘要數(shù)據(jù)指的是以小時(shí)為最小的一段時(shí)間內(nèi)位號(hào)的最大值、最小值、平均值、方差值。摘要數(shù)據(jù)能夠反映數(shù)據(jù)的穩(wěn)定性。如果要看任意時(shí)間段的統(tǒng)計(jì)數(shù)據(jù)（小于一小時(shí)的）請(qǐng)使用統(tǒng)計(jì)數(shù)據(jù)對(duì)象(SPC)。通過摘要數(shù)據(jù)控件可以得到某一位

37、號(hào)在過去某時(shí)段的統(tǒng)計(jì)信息。摘要數(shù)據(jù)控件可以同時(shí)對(duì)多個(gè)位號(hào)，多個(gè)連續(xù)時(shí)段的數(shù)據(jù)進(jìn)行統(tǒng)計(jì)。使用步驟11）在組態(tài)環(huán)境中添加摘要數(shù)據(jù)控件。12）通過其屬性框指定要查詢的位號(hào)，也可以通過該控件數(shù))。動(dòng)態(tài)增加位號(hào)(AddTag 函在通過中調(diào)用摘要數(shù)據(jù)控件的函數(shù)，啟動(dòng)查詢(調(diào)用 Start 函數(shù))?！?檢索完成時(shí)”或周期調(diào)用狀態(tài)函數(shù) IsReady 來檢查檢索是否完成。15）通過GetAverGetMinGetMaxGetDevGetCellGetCellText 等函數(shù)得到摘要數(shù)據(jù)控件中的數(shù)據(jù)。這些數(shù)據(jù)可以用于報(bào)表顯示。添加控件摘要數(shù)據(jù)控件是一圖形對(duì)象，可以通過子圖選擇框添加到窗口中。在窗口中雙擊摘要數(shù)據(jù)

38、控件將出現(xiàn)如下屬性框：第 22 頁在框中輸入要查詢摘要數(shù)據(jù)的位號(hào)名，操作步驟如下：17）選擇數(shù)據(jù)源，在下拉框中選擇要的數(shù)據(jù)源。小數(shù)位數(shù)：輸入要顯示的小數(shù)位數(shù)。忽略壞值：選中該項(xiàng)，將剔除超過量程范圍的數(shù)據(jù)。增加：在位號(hào)輸入框：輸入位號(hào)，或通過位號(hào)選擇按鈕選取位號(hào)。單擊“增加”按鈕，將位號(hào)加入到左面位號(hào)列表。刪除：?jiǎn)螕簟皠h除”按鈕，將位號(hào)從左面位號(hào)列表中刪除。修改：在左面位號(hào)列表中選擇好要修改的位號(hào)，在位號(hào)輸入框中輸入修改內(nèi)容，單擊“修改”按鈕。運(yùn)行時(shí)可見：選中該復(fù)選框，運(yùn)行時(shí)將顯示摘要數(shù)據(jù)（這樣可以調(diào)試），一般情況下，不用選擇該復(fù)選框。24）單擊“”按鈕將出現(xiàn)定義框：第 23 頁大慶紫金橋：技術(shù)

39、辦事處傳真：在定義框中可以指定控件進(jìn)入時(shí)動(dòng)作，以及數(shù)據(jù)檢索完成時(shí)動(dòng)作。函數(shù)說明：Start(Beg說明ime, Cycle, Count)開始檢索，通過函數(shù) IsReady 來檢測(cè)檢索是否完成。參數(shù)Begime ： 整型，開始時(shí)間，該時(shí)間為從 1970 年 1 月 1 日零時(shí)過去的秒數(shù)。Cycle：周期，即同一位號(hào)每個(gè)數(shù)據(jù)之間的間隔時(shí)間。 Count：每個(gè)位號(hào)要取的數(shù)據(jù)個(gè)數(shù)?？偟臅r(shí)間長(zhǎng)度為 Cycle * Count。示例：#SummCtrl.Start(LongTime(2001/01/01 14:50:48), 60, 10);/#SummCtrl.為摘要控件名稱。為秒。AddTag(Ta

40、gName, Decimal, IsAverage)說明添加位號(hào)。參數(shù)TagName：位號(hào)名稱，字符串類型。 Decimal： 整型，小數(shù)位數(shù)，0 表示無小數(shù)。 IsAverage：是否為平均值。示例：#SummCtrl. AddTag (“A1.PV”, 2, 0);第 24 頁/#SummCtrl.為控件名稱。ClearAllTag ()說明刪除所有位號(hào)。參數(shù)無。示例：#SummCtrl. ClearAllTag ();/#SummCtrl.為控件名稱。GetAver (TagName, Index)說明得到指定位號(hào)的平均值。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的

41、是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #SummCtrl.GetAver(“TI1001.PV”, 0);/ Val 為實(shí)型變量。GetMax (TagName, Index)說明得到指定位號(hào)的最大值。參數(shù)及示例與 GetAver 類似，參見 GetAvert。GetMin (TagName, Index)說明得到指定位號(hào)的最小值。參數(shù)及示例與 GetAver 類似，參見 GetAvert。GetDev (TagName, Index)說明得到指定位號(hào)的方差值。暫時(shí)沒有實(shí)現(xiàn)。參數(shù)及示例與 GetAver 類似，參見

42、 GetAvert。GetAverText (TagName, Index)說明得到指定位號(hào)的平均值字符串。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。第 25 頁大慶紫金橋：技術(shù)辦事處傳真：示例：Str = #SummCtrl.GetAverText (“TI1001.PV”, 0);/Str 為字符串型變量。GetMaxText (TagName, Index)說明得到指定位號(hào)的最大值字符串。參數(shù)及示例與 GetAverText 類似，參見 GetAverText

43、。GetM說明ext (TagName, Index)得到指定位號(hào)的最小值字符串。參數(shù)及示例與 GetAverText 類似，參見 GetAverText。GetDevText (TagName, Index)說明得到指定位號(hào)的方差字符串。暫時(shí)沒有實(shí)現(xiàn)。參數(shù)及示例與 GetAverText 類似，參見 GetAverText。GetCell(Row,Col, Type)說明得到指定單元格的數(shù)值?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。 Type：整型，

44、值類型，0：平均；1：最?。?：最大；3：方差。返回值：返回指定位號(hào)指定序號(hào)的值，為實(shí)型數(shù)。示例：Val = #SummCtrl.GetCell(0, 0,0);/ Val 為實(shí)型變量。GetCellText(Row,Col, Type)說明得到指定單元格的文本?？梢哉J(rèn)為返回的數(shù)據(jù)擺放在一表格中，每列對(duì)應(yīng)一個(gè)位號(hào)。參數(shù)Row：整型，指定的是行號(hào)，也就是數(shù)據(jù)的序號(hào)。序號(hào)從 0 開始。Col：整型，指定的是列號(hào)，也就是位號(hào)的序號(hào)。序號(hào)從 0 開始。 Type：整型，值類型，0：平均；1：最小；2：最大；3：方差。返回值：返回指定位號(hào)指定序號(hào)的字符串，類型為字符串。示例：Str = #SummCtr

45、l.GetCellText(0, 0, 0);/Str 為字符串型變量。第 26 頁GetTagName(TagIndex)說明得到指定序號(hào)的位號(hào)名稱。參數(shù)TagIndex：位號(hào)序號(hào)。序號(hào)從 0 開始。返回值：返回指定序號(hào)的位號(hào)名稱，類型為字符串。示例：Str = #SummCtrl. GetTagName (0);/Str 為字符串型變量。GetTimeText (DataIndex，F(xiàn)ormat)說明得到指定數(shù)據(jù)序號(hào)的時(shí)間字符串。參數(shù)DataIndex：數(shù)據(jù)序號(hào)。序號(hào)從 0 開始。Format：時(shí)間格式。 0：YYYY/MM/DD hh:mm:ss 1：YYYY/MM/DD2：hh:mm:

46、ss 3：YYYY/MM/DD hh:mm4：YYYY/MM/DD hh 5：MM/DD hh:mm其中 YYYY：表示年； MM：表示月； DD：表示日； hh：表示時(shí)； mm：表示分；ss：表示秒；返回值：返回指定數(shù)據(jù)序號(hào)的時(shí)間，類型為字符串。示例：Str = #SummCtrl.GetTimeText (0，0);/Str 為字符串型變量。GetM說明imeText (TagName, Index)得到指定位號(hào)在指定周期內(nèi)達(dá)到最小值的時(shí)間。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)在指定周期

47、達(dá)到最小值的時(shí)間，類型為字符串。示例：第 27 頁大慶紫金橋：技術(shù)辦事處傳真：Str = #SummCtrl. GetMimeText (“TI1001.PV”, 0);/Str 為字符串型變量。GetMaxTimeText (TagName, Index)說明得到指定位號(hào)在指定周期內(nèi)達(dá)到最大值的時(shí)間。參數(shù)TagName：位號(hào)名稱，字符串型。Index：整型，指定的是數(shù)據(jù)序號(hào)，0 表示第一個(gè)周期的數(shù)據(jù)。序號(hào)從 0 開始。返回值：返回指定位號(hào)在指定周期達(dá)到最大值的時(shí)間，類型為字符串。示例：Str = #SummCtrl. GetMaxTimeText (“TI1001.PV”, 0);/Str

48、為字符串型變量。IsReady()說明檢測(cè)檢索是否完成。參數(shù)返回值：為整型數(shù)。1：完成；0：未完成。示例：IF(#SummCtrl.IsReady () THEN/得到數(shù)據(jù)。 ENDIFGetColCount（）說明得到列數(shù)，即位號(hào)個(gè)數(shù)。參數(shù)返回值：列數(shù)，為整型數(shù)。示例：TagCount = #SummCtrl.GetRowCount();GetRowCount（）說明得到行數(shù)，即數(shù)據(jù)個(gè)數(shù)。參數(shù)返回值：行數(shù)，為整型數(shù)。示例：Dount = #SummCtrl.GetRowCount();第 28 頁第八章 歷史數(shù)據(jù)相關(guān)控件和函數(shù)1與歷史數(shù)據(jù)有關(guān)的控件除了上面講到的歷史數(shù)據(jù)檢索控件外，還有很多與

49、歷史數(shù)據(jù)顯示有關(guān)的控件包括：歷史趨勢(shì)、歷史報(bào)表、格式報(bào)表、趨勢(shì)分析。另外還有與查詢歷史數(shù)據(jù)比較密切的控件是開始時(shí)間、時(shí)間長(zhǎng)度控件，這兩個(gè)控件用于定位檢索的時(shí)間段。下面分別說明。1）歷史趨勢(shì)使用歷史趨勢(shì)可以方便的觀察數(shù)據(jù)庫(kù)中的歷史點(diǎn)在任意一個(gè)時(shí)刻的狀態(tài)。歷史趨勢(shì)帶有很多功能按鈕用于控制時(shí)間范圍或顯示的量程大小。您可以使用趨勢(shì)的自帶功能按鈕，也可以把趨勢(shì)打散，重新定制自己的按鈕外觀或更改按鈕的功能。創(chuàng)建歷史趨勢(shì)選擇菜單命令“工具/子圖”或點(diǎn)擊工具條命令按鈕左側(cè)的瀏覽樹中選中“趨勢(shì)分析”項(xiàng)目。如下圖所示：調(diào)出子圖選擇框，在框在右側(cè)列表中雙擊圖中所示圖標(biāo)或直接拖動(dòng)此圖標(biāo)到當(dāng)前窗口中，可以看到窗口中已經(jīng)

50、創(chuàng)建了歷史趨勢(shì)組件，如下圖所示：第 29 頁大慶紫金橋：技術(shù)辦事處傳真：詳細(xì)說明請(qǐng)參見畫面使用手冊(cè)。2）趨勢(shì)分析趨勢(shì)分析是圖形化的歷史數(shù)據(jù)分析界面。每個(gè)窗口同時(shí)可以顯示 8 支趨勢(shì)筆，每支筆的起始時(shí)間、時(shí)間范圍可以隨意指定，因此用戶可以對(duì)同一位號(hào)在不同時(shí)刻進(jìn)行比較。在趨勢(shì)圖中，你可以用鼠標(biāo)選擇任何區(qū)域，對(duì)其進(jìn)行放大。過程趨勢(shì)同時(shí)提供統(tǒng)計(jì)分析功能，可以對(duì)任何一段趨勢(shì)曲線的統(tǒng)計(jì)值進(jìn)行計(jì)算，幫助工藝技術(shù)員和工程師進(jìn)行統(tǒng)計(jì)分析。窗口中的趨勢(shì)筆可以隨意指定，并且可以保存到文件中，以便下次調(diào)用。關(guān)于趨勢(shì)分析的詳細(xì)說明請(qǐng)參見畫面使用手冊(cè)。3）歷史報(bào)表歷史報(bào)表是一種簡(jiǎn)單的瀏覽和打印歷史數(shù)據(jù)的控件。其格式比較簡(jiǎn)

51、單，但是使用方便，能夠滿足一般用戶要求。歷史報(bào)表從數(shù)據(jù)庫(kù)中按照固定的采樣周期獲取歷史數(shù)據(jù)，并以表格的形式顯示出來。創(chuàng)建歷史報(bào)表在菜單中選擇工具/組件對(duì)象/歷史報(bào)表，如下圖所示：第 30 頁在窗口中單擊并拖拽到合適大小后鼠標(biāo)。如下圖所示：雙擊控件，將彈出屬性“一般”頁中各項(xiàng)說明：起始時(shí)間 ：框。指定起始時(shí)刻：選中該項(xiàng)表示開始時(shí)間由下面時(shí)間輸入項(xiàng)指定。起始時(shí)刻決定于打印時(shí)間：選中該項(xiàng)表示報(bào)表打印開始時(shí)間是打印時(shí)刻前的一段時(shí)間。報(bào)表起始時(shí)間當(dāng)在單選按鈕“起始時(shí)間”選擇了“指定起始時(shí)刻”選項(xiàng)時(shí)，該項(xiàng)變?yōu)橛行?，否則為無效狀態(tài)。該項(xiàng)用于指定報(bào)表開始時(shí)間，指定從前幾天什么時(shí)刻開始。規(guī)定如下：0 表示當(dāng)天，1

52、：表示前一天，依次類推。時(shí)、分輸入項(xiàng)表示從前幾天的第幾點(diǎn)鐘（023）和第幾分鐘（059）開始。 例如 1 天 8 時(shí) 0 分，表示前一天 8 點(diǎn)整開始。字體單擊該按鈕可以選擇報(bào)表的字體和字號(hào)。第 31 頁大慶紫金橋：技術(shù)辦事處傳真：顏色有如下五種顏色可以指定：“標(biāo)題背景”，“工位號(hào)/標(biāo)題”，“序號(hào)”，“值”以及“時(shí)間”。時(shí)間該組共有四項(xiàng)，解釋如下：范圍：報(bào)表獲取歷史數(shù)據(jù)的時(shí)間長(zhǎng)度。間隔：報(bào)表歷史數(shù)據(jù)間的時(shí)間間隔，即采樣周期。顯示時(shí)間：是否顯示時(shí)間。格式：報(bào)表中時(shí)間列所占用的字符數(shù)。注意：當(dāng)選擇了“指定起始時(shí)刻”選項(xiàng)時(shí)，“范圍”和“間隔”的時(shí)間選擇了“起始時(shí)刻決定于打印時(shí)間”選項(xiàng)時(shí)，“范圍”和“間隔”的時(shí)間為小時(shí)；當(dāng)為秒。數(shù)據(jù)源選擇所連接實(shí)時(shí)數(shù)據(jù)庫(kù)的數(shù)據(jù)源。數(shù)據(jù)類型只有在選擇了“指定起始時(shí)刻”選項(xiàng)時(shí)，該項(xiàng)才變?yōu)橛行В駝t為禁止?fàn)顟B(tài)。該項(xiàng)用于指定歷史報(bào)表采樣的數(shù)據(jù)類型。類型如下：瞬時(shí)值得到指定時(shí)間段內(nèi)，固定采樣點(diǎn)的瞬時(shí)值。平均值得到指定時(shí)間段內(nèi)，每個(gè)周期內(nèi)的平均值。最大值得到指定時(shí)間段內(nèi)，每個(gè)周期內(nèi)的最大值。最小值得到指定時(shí)間段內(nèi)，每個(gè)周期內(nèi)的最小值。“變量”