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

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

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

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

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

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

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

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

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

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

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

12、返回錯誤碼； 進度指示錯誤碼：返回-1-文件不能打開返回-2-沒有可導出的數據返回-4-文件操作出現錯誤控制數據對象名：指定一個開關型數據對象,該對象控制導出執行，啟動導出時會自動設置該變量為0，用戶在導出過程中想取消導出則可以設置該值為0的任何值，導出函數運行結束后會自動設置對象值為1； 進度指示錯誤碼：返回0-導出成功返回-1-導出路徑不存在返回1-指定組對象錯誤，可能組對象沒有保存歷史數據或者沒有該組對象返回2-指定的時間格式錯誤返回3-指定的無效的數據對象名返回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)函數意義：讀取數據對象DatName報警限值，只有在數據對象DatName的“允許進行報警處理”屬性選項被選中后，本函數的操作才有意義。對組對象、字符型數據對象、事件型數據對象本函數無效。對數值型數據對象，用Flag來標識讀取何種報警限值。返 回 值：數值型，返回值=0：調用正常，0：調用不正常。參 數：DatName：數據對象名。Value：DataName的當前的報警限值，數值

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

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

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

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

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

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

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

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

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

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

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