昆侖通態(tài)腳本

1、相關(guān)內(nèi)容回首頁數(shù)據(jù)對象操作函數(shù)!An swerAlm(DatName)函數(shù)意義：應(yīng)答數(shù)據(jù)對象DatName所產(chǎn)生的報警。如對應(yīng)的數(shù)據(jù)對象沒有報警產(chǎn)生 或已經(jīng)應(yīng)答，如此本函數(shù)無效。返回值：數(shù)值型，=0為操作成功，0為操作失敗。參數(shù)：DatName數(shù)據(jù)對象名。實例：！AnswerAlm(電機溫度)，應(yīng)答數(shù)據(jù)對象“電機溫度所產(chǎn)生的報警。!Cha ngeDataSave(Dat name ,n)函數(shù)意義：改變數(shù)據(jù)對象 Datname存盤的周期。返回值：數(shù)值型，=0為操作成功，0為操作失敗。參數(shù)：Datname,數(shù)據(jù)對象名；n,數(shù)值型，以秒表示的存盤間隔時間。實例：！ChangeDataSave(溫度,

2、5)，溫度的存盤間隔時間為5秒。!Cha ngeSaveData(DatName,Num1,Num2)該函數(shù)在通用版中可以使用，在嵌入版中不能使用！函數(shù)意義：改變數(shù)據(jù)對象 DatName所對應(yīng)存盤數(shù)據(jù)的存盤間隔，把Num1小時以前的存盤數(shù)據(jù)以當前時間為0點的存盤間隔改為 Num2秒。本操作只 對組對象有效，對單個的數(shù)據(jù)對象無效。當DataName =空字符，或Num仁0或Num2=0時，本操作無效。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：DatName數(shù)據(jù)對象名。Num1數(shù)值型時間量，單位：小時。本函數(shù)用Num10的一些數(shù)值來表示一些特殊意義的操作：=-1改變當天對應(yīng)數(shù)據(jù)對

3、象所有存盤數(shù)據(jù)的存盤間隔；=-2改變昨天對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；=-3改變本星期對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；=-4改變上星期對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；=-5改變本月對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；=-6改變上個月對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；Num2數(shù)值型時間量，新的存盤間隔，單位：秒。實例：！ChangeSaveData(電機1,-2,5)，把組對象電機1對應(yīng)的存盤數(shù)據(jù)中昨天的存盤數(shù)據(jù)的存盤間隔改為5秒鐘。!FlushDatal ni tValueToDisk()函數(shù)意義：把所有數(shù)據(jù)對象的初始值寫入磁盤，調(diào)用后即刻刷盤。返回值：數(shù)值型，返回值=0：調(diào)用

4、正常，0:調(diào)用不正常。參數(shù)：無。!FreshSaveData()函數(shù)意義：實現(xiàn)報警組對象和事件組對象存盤周期為0的強制刷盤功能。調(diào)用后即刻將報警組對象和事件組對象在內(nèi)存緩沖區(qū)中的存盤數(shù)據(jù)強制寫入磁盤。返 回 值：數(shù)值型，返回值=0：調(diào)用正常，0：調(diào)用不正常。參數(shù)：無。!CopySaveDat()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保存。!DataGetInt （變量名，返回值）函數(shù)意義：通過變量名讀開關(guān)型變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型，開關(guān)型變量的名稱返回值，開關(guān)型，保存返回的值。實例：Ret=!Data

5、GetI nt（變量名,Int）。!DataGetFloat(變量名，返回值）函數(shù)意義：通過變量名讀數(shù)值型變量的值。返回值：開關(guān)型，返回0：執(zhí)行成功；返回1：類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型 。返回值，數(shù)值型，保存返回的值。實例：Ret=!DataGetFloat（變量名，F(xiàn)loat）。!DataGetString（變量名，返回值）函數(shù)意義：通過變量名讀字符型變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型。返回值，字符型，保存返回的值。實例：Ret=!DataGetString（變量名,Str）。!DataSetI

6、nt （變量名，設(shè)置值）函數(shù)意義：通過變量名寫開關(guān)型變量的值。返回值：開關(guān)型，返回0:執(zhí)行成功；返回1:類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型。設(shè)置值，開關(guān)型，要設(shè)置的值。實例：Ret=!DataSetInt （變量名，lnt）。!DataSetFloat（ 變量名，設(shè)置值）函數(shù)意義：通過變量名寫數(shù)值型變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型。設(shè)置值，數(shù)值型，要設(shè)置的值。實例：Ret=!DataSetFloat（ 變量名,Float）。!DataSetString（變量名，設(shè)置值）函數(shù)意義：通過變量名寫字符型變量的

7、值。返回值：開關(guān)型,返回o :執(zhí)行成功；返回1：類型不匹配；返回3:變量不存在。參數(shù)：變量名，字符型。設(shè)置值，字符型，要設(shè)置的值。實例：Ret=!DataSetString（變量名，Str）。!DelSaveDat（DatName,Num）函數(shù)意義：刪除組對象 DatName對應(yīng)的存盤數(shù)據(jù)中最早 Num小時內(nèi)的存盤數(shù)據(jù)， 如果Num 0,就刪除以當前時間為基點Num個小時之前的內(nèi)容，刪除時是按文件刪除的，如果數(shù)據(jù)不足一個存盤文件，是不會被刪除的。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：DatName組對象名。Num ,參數(shù)名。實例：！DelSaveDat（電機溫度，12），

8、刪除組對象“電機溫度對應(yīng)的存盤數(shù)據(jù)中以當前時間為基點倒推12個小時之前的數(shù)據(jù)。但從當前時間至倒推的12個小時之內(nèi)的內(nèi)容會被保存。注意：該函數(shù)只對組對象操作有效。!DelAIISaveDat()函數(shù)意義：刪除組對象 DataName對應(yīng)的所有存盤數(shù)據(jù)。注意，此函數(shù)不能用來刪 除組對象所對應(yīng)的報警存盤數(shù)據(jù)。返回值：數(shù)值型，返回值=0：調(diào)用正常，o：調(diào)用不正常。參數(shù)：DatName組對象名；實例：！DelAIISaveDat 電機溫度，刪除組對象“電機溫度對應(yīng)的所有存盤數(shù)據(jù)注意：該函數(shù)只對組對象操作有效。!En ableDataSave （n ame ,n）函數(shù)意義：打開/關(guān)閉數(shù)據(jù)對象的定時存盤功能

9、。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：name,數(shù)據(jù)對象名；n,數(shù)值型，1表示打開定時存盤，0表示關(guān)閉定時存盤。實例：！EnableDataSave（溫度,1），打開溫度的定時存盤。!ExportHisDataToCSV（文件名，組對象名，字段名，開始時間，完畢時間，最大記錄數(shù)，導出模 式,導出參數(shù)，進度指示數(shù)據(jù)對象名，取消控制數(shù)據(jù)對象名）函數(shù)意義：1. 導出指定組對象存盤數(shù)據(jù)，導出的條件包括：開始時間-完畢時間,最大導出總條數(shù)；2. 導出字段列表，組對象為MCGS_ALAF如此表示導出報警歷史數(shù)據(jù)；3. 可指定導出文件名和路徑，主要是U盤導出，可以追加方式也可覆蓋方式

10、導出；4. 可顯示導出過程進度情況；5. 可取消和中止長時間的導出過程；6. 導出格式為csv文件，導出的第一行為字段名字。返回值：開關(guān)型。返回1有該組對象返回2返回3返回4返回5指定組對象錯誤，可能組對象沒有保存歷史數(shù)據(jù)或者沒指定的時間格式錯誤指定的無效的數(shù)據(jù)對象名無效的導出模式參數(shù):文件名:字符型，指定導出的文件絕對路徑名,指定的第一級目錄不能創(chuàng)建，其子目錄如果不存在如此可以創(chuàng)建。這樣防止U盤不存在時創(chuàng)建U盤目錄。注意：第一級目錄不能自動創(chuàng)建用戶必須保證其存在;組對象名：導出的組對象名字。字段名：字符型，用逗號分隔的要導出的字段名，不需要指定時間字段，默認第一二個字段就為記錄時間字段。如果

11、為空字符串如此導出所有字段。開始時間，完畢時間：用表示的時間字符串“YYYY-MM-DIHH MM SS;最大記錄數(shù)：希望導出的最大記錄數(shù)，超過該記錄數(shù)就返回，停止導出；導出模式：“T表示覆蓋現(xiàn)有文件，“2表示追加到文件最后；導出參數(shù)：暫時為空，保存以后使用；進度指示數(shù)據(jù)對象名：開關(guān)型數(shù)據(jù)對象，導出過程中該對象值反映出當前已導出記錄條數(shù)，如果導出過程中其他異常完畢如此通過該對象返回同函數(shù)返回錯誤碼；進度指示錯誤碼同時只能支持一個csv導出打開出的數(shù)據(jù)出現(xiàn)錯誤返回-1文件不能返回-2沒有可導返回-4文件操作控制數(shù)據(jù)對象名：指定一個開關(guān)型數(shù)據(jù)對象，該對象控制導出執(zhí)行，啟動導出時會自動設(shè)置該變量為

12、0，用戶在導出過程中想取 消導出如此可以設(shè)置該值為 0的任何值，導出函數(shù)運 行完畢后會自動設(shè)置對象值為 1 ；進度指示錯誤碼：返回0-導出成功 返回-1- 導出路徑不存在返回1-指定組對象錯誤，可能組對象沒有保存歷史數(shù)據(jù)或者沒有該組對象返回2 指定的時間格式錯誤返回3 指定的無效的數(shù)據(jù)對象名返回4-無效的導出模式返回5-同時只能支持一個csv導出ret=!ExportHisDataToCSV(usb0:0:0,2009/1/1harddiskya ng.csv,group,data1,data4,2007/1/1 0:0:0,20000,1, 進度，控制)!GetAlmValue(DatNam

13、e,Value,Flag)函數(shù)意義：讀取數(shù)據(jù)對象DatName報警限值，只有在數(shù)據(jù)對象DatName的允許進 展報警處理屬性選項被選中后，本函數(shù)的操作才有意義。 對組對象、字符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)對象， 用Flag來標識讀取何種報警限值。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：DatName數(shù)據(jù)對象名。Value : DataName的當前的報警限值，數(shù)值型。Flag :數(shù)值型，標志要讀取何種限值，具體意義如下：=1下下限報警值；=2下限報警值；=3上限報警值；=4上上限報警值；=5下偏差報警限值；=6上偏差報警限值；=7偏差報警基準值；實例:

14、!GetAlmValue(電機溫度，Value,3)，讀取數(shù)據(jù)對象“電機溫度的報警上限值，放入數(shù)值型數(shù)據(jù)對象Value中。!GetEve ntDT()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保存。!GetEve ntP()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保存。!GetEve ntT()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保存。! GroupGetInt (組對象變量，成員編號，返回值)函數(shù)意義：讀取組對象中指定的開關(guān)型成員變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或

15、指定變量不是組對象。參數(shù)：組對象變量，組對象類型。從0開始。成員編號，開關(guān)型，成員變量在組對象中的編號, 返回值，開關(guān)型，保存返回的值。實例：Ret=!GroupGetlnt(Group,0,lnt)。!GroupGetFloat( 組對象變量，成員編號，返回值)函數(shù)意義返回值：象。參實!GroupGetStri ng(函數(shù)意義返回值：象。參:讀取組對象中指定的數(shù)值型成員變量的值。開關(guān)型，返回0 :執(zhí)行成功；返回1：類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或指定變量不是組對數(shù)：組對象變量，組對象類型。成員編號，開關(guān)型，成員變量在組對象中的編號,返回值，數(shù)值型

16、，保存返回的值。例：Ret=!GroupGetFloat(Group,0,Float) 。組對象變量，成員編號，返回值):讀取組對象中指定的字符型成員變量的值。開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或指定變量不是組對數(shù)：組對象變量，組對象類型。成員編號，開關(guān)型，成員變量在組對象中的編號，從從0開始。0開始。返回值，字符型，保存返回的值。實例：Ret=!GroupGetString(Group,0,String)。!GroupSetInt (組對象變量，成員編號，設(shè)置值)函數(shù)意義：設(shè)置組對象中指定的開關(guān)型成員變量的值。返回

17、值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或指定變量不是組對象。參數(shù)：組對象變量，組對象類型。0開始。成員編號，開關(guān)型，成員變量在組對象中的編號，從 設(shè)置值，開關(guān)型，要設(shè)置的值。實例：Ret=!GroupSet In t (Group,0,I nt)。!GroupSetFloat( 組對象變量，成員編號，設(shè)置值)函數(shù)意義：設(shè)置組對象中指定的數(shù)值型成員變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或指定變量不是組對象。參數(shù)：組對象變量，組對

18、象類型。成員編號，開關(guān)型，成員變量在組對象中的編號，從0開始。設(shè)置值，數(shù)值型，要設(shè)置的值。實例：Ret=!GroupSetFloat(Group,0,Float)!GroupSetStri ng(組對象變量，成員編號，設(shè)置值)函數(shù)意義：設(shè)置組對象中指定的字符型成員變量的值。返回值：開關(guān)型，返回0 :執(zhí)行成功；返回1:類型不匹配；返回2 :指定編號超出組對象索引X圍；返回3 :指定組對象不存在或指定變量不是組對象。參數(shù)：組對象變量，組對象類型。成員編號，開關(guān)型，成員變量在組對象中的編號，從0開始。設(shè)置值，字符型，要設(shè)置的值。實例：Ret=!GroupSetString(Group,0,Strin

19、g)。!MoveSaveDat()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保存。!SaveData(DatName)函數(shù)意義：把數(shù)據(jù)對象DataName對應(yīng)的當前值存入存盤數(shù)據(jù)庫中。本函數(shù)的操作 使對應(yīng)的數(shù)據(jù)對象的值存盤一次。此數(shù)據(jù)對象必須具有存盤屬性，且 存盤時間需設(shè)為0秒。否如此會操作失敗。返回值：數(shù)值型，=0為操作成功，0為操作失敗。參數(shù)：DatName數(shù)據(jù)對象名。實例：！SaveData(電機1)，把組對象“電機 T的所有成員對應(yīng)的當前值存盤一次。!SaveDataI ni t()函數(shù)說明：此函數(shù)在 McgsE7.603.0001丨與以后版本中無效，考慮兼容性問題， 故保存。

20、!SaveData On Time(Time,TimeMS,DataName)函數(shù)意義：使用指定時間保存數(shù)據(jù)。本函數(shù)通常用于指定時間來保存數(shù)據(jù)，實現(xiàn)與通常機制不一樣的存盤方法。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：Time,數(shù)值型，使用時間函數(shù)轉(zhuǎn)換出的時間量。時間精度到秒。TimeMS數(shù)值型，指定存盤時間的毫秒數(shù)。實例：t =!TimeStr2l(2001 年 2 月 21 日 3 時 2 分 3 秒)；SaveData On Time(t,0,DataGroup)，按照指定時間保存數(shù)據(jù)對象。!SaveS in gleDatal ni t(Name)函數(shù)意義：本操作把數(shù)據(jù)

21、對象的當前值設(shè)置為初始值不管該對象是否設(shè)置有“退出時自動保存數(shù)據(jù)對象的當前值作為初始值屬性，防止突然斷電而無法保存，以便MCG歐入版下次啟動時這些數(shù)據(jù)對象能自動恢復其 值。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：Name數(shù)據(jù)對象名。實例：！SaveSingleDatalnit(溫度)，把溫度的當前值設(shè)置成初始值。(DatName,Value,Flag)函數(shù)意義：設(shè)置數(shù)據(jù)對象 DatName對應(yīng)的報警限值，只有在數(shù)據(jù)對象DatName允許進展報警處理的屬性被選中后，本函數(shù)的操作才有意義。對組對象、字符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)對象，用Flag來標識改變

22、何種報警限值。返回值：數(shù)值型，返回值=0：調(diào)用正常，0:調(diào)用不正常。參數(shù)：DatName數(shù)據(jù)對象名。Value :新的報警值，數(shù)值型。Flag :數(shù)值型，標志要操作何種限值，具體意義如下：=1下下限報警值；=2下限報警值；=3上限報警值；16 / 20=5下偏差報警限值;=6上偏差報警限值;=7偏差報警基準值;例：！（電機溫度，200,3），把數(shù)據(jù)對象“電機溫度的報警上限值設(shè)為200!TransToUSB（組對象名，起始時間，完畢時間，導出狀態(tài)，進度指示，轉(zhuǎn)出模式，保存參數(shù)）函數(shù)意義：將XXX組對象的存盤數(shù)據(jù)導出到 USBHARDDISK目錄下，保存為“XXX.csv文件，模擬環(huán)境如此是保存到

23、與可執(zhí)行文件一樣路徑下。返回值：開關(guān)型。0:參數(shù)沒有錯誤。1：第一個參數(shù)錯誤。請檢查是否組對象名稱，或“MCGS_ALARM2:時間參數(shù)格式錯誤。3:狀態(tài)變量的類型錯誤。兩個變量都必須是開關(guān)量5:同時只能支持一個 csv導出。參數(shù)： 組對象名：字符型，要導出的組對象名稱 或“MCGS_ALARM。起始時間：字符型，要導出的歷史數(shù)據(jù)的開始時間，格式：YYYY-MM-DDHH:MM:SS完畢時間：字符型，要導出的歷史數(shù)據(jù)的完畢時間，格式：YYYY-MM-DDHH:MM:SS導出狀態(tài)：開關(guān)型，進度指示數(shù)據(jù)對象名開關(guān)量,輸出導出狀態(tài)。正常導出存盤后輸出當前已經(jīng)導出的記錄條數(shù)。當創(chuàng)建導出文件 “ XXX

24、.csv失敗時輸出1。請檢查下位機是否正常插入了 U盤當前沒有記錄可導出時輸出-2。請檢查對應(yīng)的組對象是否有存盤信息，或者開始時間完畢時間是否設(shè)置正確導出過程中出現(xiàn)未知數(shù)據(jù)類型時輸出一3。不應(yīng)該出現(xiàn)導出過程中出現(xiàn)文件操作異常時輸出一4。請檢查U盤容量是否足夠進度指示：開關(guān)量，指定一個數(shù)字型或開關(guān)型對象，該對象控制導出執(zhí)行，啟動導出時會自動設(shè)置該變量為0,用戶在導出過程中想取消導出可設(shè)置該變量為0的任何值，導出函數(shù)運行完畢后會自動設(shè)置對象 值為1。注：之前的版本，此參數(shù)為原導出狀態(tài)變量2，顯示的是導出數(shù)據(jù)總條數(shù)。轉(zhuǎn)出模式：開關(guān)型，保存，設(shè)置為0。保存參數(shù)：字符型，保存，設(shè)置為空字符串。實 例：!Tra nsToUSB(MCGS_ALARM , 2008-12-1 00:00:00,