昆侖通態(tài)腳本

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

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

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

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

5、 返回值，開關型，保存返回的值。 實 例： Ret=!DataGetInt(變量名,Int)。 !DataGetFloat(變量名，返回值) 函數(shù)意義：通過變量名讀數(shù)值型變量的值。返 回 值：開關型， 返回0：執(zhí)行成功； 返回1：類型不匹配； 返回3：變量不存在。參數(shù)：變量名，字符型。 返回值，數(shù)值型，保存返回的值。 實 例： Ret=!DataGetFloat(變量名,Float)。!DataGetString(變量名，返回值) 函數(shù)意義：通過變量名讀字符型變量的值。返 回 值：開關型， 返回0：執(zhí)行成功； 返回1：類型不匹配； 返回3：變量不存在。參數(shù)：變量名，字符型。 返回值，字符型，保

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

7、!DataSetFloat(變量名,Float)。!DataSetString(變量名，設置值) 函數(shù)意義：通過變量名寫字符型變量的值。返 回 值：開關型， 返回0：執(zhí)行成功； 返回1：類型不匹配； 返回3：變量不存在。參數(shù)：變量名，字符型。 設置值，字符型，要設置的值。實 例： Ret=!DataSetString(變量名,Str)。!DelSaveDat(DatName,Num)函數(shù)意義：刪除組對象DatName對應的存盤數(shù)據(jù)中最早Num小時內的存盤數(shù)據(jù)，如果 Num 0, 就刪除以當前時間為基點Num個小時之前的內容,刪除時是按文件刪除的，如果數(shù)據(jù)不足一個存盤文件，是不會被刪除的。返 回

8、 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：DatName，組對象名。 Num , 參數(shù)名。實 例：!DelSaveDat(電機溫度，12) ，刪除組對象“電機溫度”對應的存盤數(shù)據(jù)中以當前時間為基點倒推12個小時之前的數(shù)據(jù)。但從當前時間至倒推的12個小時之內的內容會被保存。注 意：該函數(shù)只對組對象操作有效。!DelAllSaveDat()函數(shù)意義：刪除組對象DataName對應的所有存盤數(shù)據(jù)。注意，此函數(shù)不能用來刪除組對象所對應的報警存盤數(shù)據(jù)。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：DatName：組對象名；實 例：!DelAllSaveDat（電機溫

9、度），刪除組對象“電機溫度”對應的所有存盤數(shù)據(jù)注 意：該函數(shù)只對組對象操作有效。!EnableDataSave(name,n)函數(shù)意義：打開/關閉數(shù)據(jù)對象的定時存盤功能。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：name，數(shù)據(jù)對象名；n，數(shù)值型，1表示打開定時存盤，0表示關閉定時存盤。實 例：!EnableDataSave(溫度,1)， 打開溫度的定時存盤。!ExportHisDataToCSV(文件名,組對象名,字段名,開始時間,結束時間,最大記錄數(shù),導出模式,導出參數(shù),進度指示數(shù)據(jù)對象名,取消控制數(shù)據(jù)對象名)函數(shù)意義：1.導出指定組對象存盤數(shù)據(jù)，導出的條件包括：開始

10、時間-結束時間，最大導出總條數(shù);2.導出字段列表，組對象為MCGS_ALARM則表示導出報警歷史數(shù)據(jù)；3.可指定導出文件名和路徑，主要是U盤導出，可以追加方式也可覆蓋方式導出；4.可顯示導出過程進度情況；5.可取消和中止長時間的導出過程；6.導出格式為csv文件，導出的第一行為字段名字。返 回 值：開關型。返回1 指定組對象錯誤，可能組對象沒有保存歷史數(shù)據(jù)或者沒有該組對象返回2 指定的時間格式錯誤返回3 指定的無效的數(shù)據(jù)對象名返回4 無效的導出模式返回5 同時只能支持一個csv導出參 數(shù)：文件名：字符型，指定導出的文件絕對路徑名，指定的第一級目錄不能創(chuàng)建，其子目錄如果不存在則可以創(chuàng)建。這樣避免

11、U盤不存在時創(chuàng)建U盤目錄。注意：第一級目錄不能自動創(chuàng)建用戶必須保證其存在；組對象名：導出的組對象名字。字段名：字符型，用逗號分隔的要導出的字段名，不需要指定時間字段，默認第一二個字段就為記錄時間字段。如果為空字符串則導出所有字段。開始時間，結束時間：用表示的時間字符串 “YYYY-MM-DD HH：MM：SS”；最大記錄數(shù)：希望導出的最大記錄數(shù)，超過該記錄數(shù)就返回，停止導出；導出模式：“1”表示覆蓋現(xiàn)有文件，“2”表示追加到文件最后；導出參數(shù)：暫時為空，保留以后使用；進度指示數(shù)據(jù)對象名：開關型數(shù)據(jù)對象，導出過程中該對象值反映出當前已導出記錄條數(shù)，如果導出過程中其他異常結束則通過該對象返回同函數(shù)

12、返回錯誤碼； 進度指示錯誤碼：返回-1-文件不能打開返回-2-沒有可導出的數(shù)據(jù)返回-4-文件操作出現(xiàn)錯誤控制數(shù)據(jù)對象名：指定一個開關型數(shù)據(jù)對象,該對象控制導出執(zhí)行，啟動導出時會自動設置該變量為0，用戶在導出過程中想取消導出則可以設置該值為0的任何值，導出函數(shù)運行結束后會自動設置對象值為1； 進度指示錯誤碼：返回0-導出成功返回-1-導出路徑不存在返回1-指定組對象錯誤，可能組對象沒有保存歷史數(shù)據(jù)或者沒有該組對象返回2-指定的時間格式錯誤返回3-指定的無效的數(shù)據(jù)對象名返回4-無效的導出模式返回5-同時只能支持一個csv導出實 例: ret= !ExportHisDataToCSV(usb har

13、ddiskyang.csv,group,data1,data4,2007/1/1 0:0:0,2009/1/1 0:0:0,20000,1,進度,控制)!GetAlmValue(DatName,Value,Flag)函數(shù)意義：讀取數(shù)據(jù)對象DatName報警限值，只有在數(shù)據(jù)對象DatName的“允許進行報警處理”屬性選項被選中后，本函數(shù)的操作才有意義。對組對象、字符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)對象，用Flag來標識讀取何種報警限值。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：DatName：數(shù)據(jù)對象名。Value：DataName的當前的報警限值，數(shù)值

14、型。Flag：數(shù)值型，標志要讀取何種限值，具體意義如下：=1下下限報警值；=2 下限報警值；=3 上限報警值；=4 上上限報警值；=5 下偏差報警限值；=6 上偏差報警限值；=7 偏差報警基準值；實 例:!GetAlmValue(電機溫度,Value,3)，讀取數(shù)據(jù)對象“電機溫度”的報警上限值，放入數(shù)值型數(shù)據(jù)對象Value中。!GetEventDT()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保留。!GetEventP()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保留。!GetEventT()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保留。!GroupGetInt (組

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

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

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

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

19、功； 返回1：類型不匹配； 返回2：指定編號超出組對象索引范圍； 返回3：指定組對象不存在或指定變量不是組對象。 參 數(shù)： 組對象變量，組對象類型。 成員編號，開關型，成員變量在組對象中的編號，從0開始。 設置值，字符型，要設置的值。實 例： Ret=!GroupSetString(Group,0,String)。!MoveSaveDat()函數(shù)說明：此函數(shù)在嵌入版中無效，考慮兼容性問題，故保留。!SaveData(DatName)函數(shù)意義：把數(shù)據(jù)對象DataName對應的當前值存入存盤數(shù)據(jù)庫中。本函數(shù)的操作使對應的數(shù)據(jù)對象的值存盤一次。此數(shù)據(jù)對象必須具有存盤屬性，且存盤時間需設為0秒。否則會

20、操作失敗。返 回 值：數(shù)值型，=0為操作成功，0為操作失敗。參 數(shù)：DatName，數(shù)據(jù)對象名。實 例：!SaveData(電機1)，把組對象“電機1”的所有成員對應的當前值存盤一次。!SaveDataInit()函數(shù)說明：此函數(shù)在McgsE7.6（03.0001）及以后版本中無效，考慮兼容性問題，故保留。!SaveDataOnTime(Time,TimeMS,DataName)函數(shù)意義：使用指定時間保存數(shù)據(jù)。本函數(shù)通常用于指定時間來保存數(shù)據(jù)，實現(xiàn)與通常機制不一樣的存盤方法。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：Time，數(shù)值型，使用時間函數(shù)轉換出的時間量。時間精度

21、到秒。TimeMS，數(shù)值型，指定存盤時間的毫秒數(shù)。實 例：t =!TimeStr2I(2001年2月21日3時2分3秒)；!SaveDataOnTime (t,0,DataGroup)， 按照指定時間保存數(shù)據(jù)對象。!SaveSingleDataInit(Name)函數(shù)意義：本操作把數(shù)據(jù)對象的當前值設置為初始值（不管該對象是否設置有“退出時自動保存數(shù)據(jù)對象的當前值作為初始值”屬性），防止突然斷電而無法保存，以便MCGS嵌入版下次啟動時這些數(shù)據(jù)對象能自動恢復其值。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：Name，數(shù)據(jù)對象名。實 例：!SaveSingleDataInit(

22、溫度)，把溫度的當前值設置成初始值。!SetAlmValue(DatName,Value,Flag)函數(shù)意義：設置數(shù)據(jù)對象DatName對應的報警限值，只有在數(shù)據(jù)對象DatName“允許進行報警處理”的屬性被選中后，本函數(shù)的操作才有意義。對組對象、字符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)對象，用Flag來標識改變何種報警限值。返 回 值：數(shù)值型，返回值=0：調用正常，0：調用不正常。參 數(shù)：DatName：數(shù)據(jù)對象名。Value：新的報警值，數(shù)值型。Flag：數(shù)值型，標志要操作何種限值，具體意義如下：=1下下限報警值；=2下限報警值；=3上限報警值；=4上上限報警值；=5下偏差報

23、警限值；=6上偏差報警限值；=7偏差報警基準值；實 例：!SetAlmValue(電機溫度,200,3)，把數(shù)據(jù)對象“電機溫度”的報警上限值設為200!TransToUSB(組對象名,起始時間,結束時間,導出狀態(tài),進度指示,轉出模式,保留參數(shù))函數(shù)意義：將XXX組對象的存盤數(shù)據(jù)導出到USB HARDDISK目錄下，保存為“XXX.csv”文件，模擬環(huán)境則是保存到與可執(zhí)行文件相同路徑下。返 回 值：開關型。0：參數(shù)沒有錯誤。 1：第一個參數(shù)錯誤。（請檢查是否組對象名稱，或“MCGS_ALARM”） 2: 時間參數(shù)格式錯誤。 3：狀態(tài)變量的類型錯誤。（兩個變量都必須是開關量） 5：同時只能支持一個

24、csv導出。參 數(shù)： 組對象名：字符型，要導出的組對象名稱（或“MCGS_ALARM”）。起始時間：字符型，要導出的歷史數(shù)據(jù)的開始時間，格式：YYYY-MM-DD HH:MM:SS。結束時間：字符型，要導出的歷史數(shù)據(jù)的結束時間，格式：YYYY-MM-DD HH:MM:SS。導出狀態(tài)：開關型，進度指示數(shù)據(jù)對象名（開關量），輸出導出狀態(tài)。 正常導出存盤后輸出當前已經導出的記錄條數(shù)。 當創(chuàng)建導出文件“XXX.csv”失敗時輸出1。（請檢查下位機是否正常插入了U盤） 當前沒有記錄可導出時輸出2。（請檢查對應的組對象是否有存盤信息，或者開始時間結束時間是否設置正確） 導出過程中出現(xiàn)未知數(shù)據(jù)類型時輸出3。（不應該出現(xiàn)） 導出過程中出現(xiàn)文件操作異常時輸出4。（請檢查U盤容量是否足夠）進度指示：開關量，指定一個數(shù)字型或開關型對象,該對象控制導出執(zhí)行，啟動導出時會自動設置該變量為0，用戶在導出過程中想取消導出可設置該變量為0的任何值，導出函數(shù)運行結束后會自動設置對象值為1。 注：6.5（01.0010）之前的版本，此參數(shù)為原導出狀態(tài)變量2，顯示的是導出數(shù)據(jù)總條數(shù)。轉出模式：開關型，保留，設置為0。保留參數(shù)：字符型，保留, 設置為空字符串。實 例：!TransToUSB(MCGS_ALARM , 2008-12-1 00:00:00 , 2008-