| ||||
数据对象操作函数
!AnswerAlm(DatName)
函数意义：应答数据对象DatName所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函数无效。
返 回 值：数值型，=0为操作成功，<>0为操作失败。
参 数：DatName，数据对象名。
实 例：!AnswerAlm(电机温度)，应答数据对象“电机温度”所产生的报警。
!ChangeDataSave(Datname,n)
函数意义：改变数据对象Datname存盘的周期。
返 回 值：数值型，=0为操作成功，<>0为操作失败。
参 数：Datname，数据对象名；n，数值型，以秒表示的存盘间隔时间。
实 例：!ChangeDataSave(温度,5)， 温度的存盘间隔时间为5秒。
!ChangeSaveData(DatName,Num1,Num2)
该函数在通用版中可以使用，在嵌入版中不能使用！
函数意义：改变数据对象DatName所对应存盘数据的存盘间隔，把Num1小时以前的存盘数据（以当前时间为0点）的存盘间隔改为Num2秒。本操作只对组对象有效，对单个的数据对象无效。当DataName =空字符，或Num1=0或Num2=0时，本操作无效。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：DatName：数据对象名。
float()函数Num1：数值型时间量，单位：小时。本函数用Num1<0的一些数值来表示一些特殊意义的操作：
=-1 改变当天对应数据对象所有存盘数据的存盘间隔；
=-2 改变昨天对应数据对象所有存盘数据的存盘间隔；
=-3 改变本星期对应数据对象所有存盘数据的存盘间隔；
=-4 改变上星期对应数据对象所有存盘数据的存盘间隔；
=-5 改变本月对应数据对象所有存盘数据的存盘间隔；
=-6 改变上个月对应数据对象所有存盘数据的存盘间隔；
Num2：数值型时间量，新的存盘间隔，单位：秒。
实 例：!ChangeSaveData(电机1,-2,5)，把组对象“电机1”对应的存盘数据中昨天的存盘数据的存盘间隔改为5秒钟。
!FlushDataInitValueToDisk()
函数意义：把所有数据对象的初始值写入磁盘，调用后即刻刷盘。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：无。
!FreshSaveData()
函数意义:实现报警组对象和事件组对象（存盘周期为0）的强制刷盘功能。调用后即刻将报警组对象和事件组对象在内存缓冲区中的存盘数据强制写入磁盘。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：无。
!CopySaveDat()
函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。
!DataGetInt (变量名，返回值)
函数意义：通过变量名读开关型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型，开关型变量的名称 。
返回值，开关型，保存返回的值。
实 例： Ret=!DataGetInt(变量名,Int)。
!DataGetFloat(变量名，返回值)
函数意义：通过变量名读数值型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型 。
返回值，数值型，保存返回的值。
实 例： Ret=!DataGetFloat(变量名,Float)。
!DataGetString(变量名，返回值)
函数意义：通过变量名读字符型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型 。
返回值，字符型，保存返回的值。
实 例： Ret=!DataGetString(变量名,Str)。
!DataSetInt (变量名，设置值)
函数意义：通过变量名写开关型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型 。
设置值，开关型，要设置的值。
实 例： Ret=!DataSetInt (变量名,Int)。
!DataSetFloat(变量名，设置值)
函数意义：通过变量名写数值型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型 。
设置值，数值型，要设置的值。
实 例： Ret=!DataSetFloat(变量名,Float)。
!DataSetString(变量名，设置值)
函数意义：通过变量名写字符型变量的值。
返 回 值：开关型，
返回0：执行成功；
返回1：类型不匹配；
返回3：变量不存在。
参 数：变量名，字符型 。
设置值，字符型，要设置的值。
实 例： Ret=!DataSetString(变量名,Str)。
!DelSaveDat(DatName,Num)
函数意义：删除组对象DatName对应的存盘数据中最早Num小时内的存盘数据，如果 Num <= 0 ,那么就是删除该组对象全部的存盘数据。如果 Num > 0, 就删除以当前时间为基点Num个小时之前的内容,删除时是按文件删除的，如果数据不足一个存盘文件，是不会被删除的。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：DatName，组对象名。
Num , 参数名。
实 例：!DelSaveDat(电机温度，12) ，删除组对象“电机温度”对应的存盘数据中以当前时间为基点倒推12个小时之前的数据。但从当前时间至倒推的12个小时之内的内容会被保存。
注 意：该函数只对组对象操作有效。
!DelAllSaveDat()
函数意义：删除组对象DataName对应的所有存盘数据。注意，此函数不能用来删除组对象所对应的报警存盘数据。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：DatName：组对象名；
实 例：!DelAllSaveDat（电机温度），删除组对象“电机温度”对应的所有存盘数据
注 意：该函数只对组对象操作有效。
!EnableDataSave(name,n)
函数意义：打开/关闭数据对象的定时存盘功能。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。
参 数：name，数据对象名；
n，数值型，1表示打开定时存盘，0表示关闭定时存盘。
实 例：!EnableDataSave(温度,1)， 打开温度的定时存盘。
!ExportHisDataToCSV(文件名,组对象名,字段名,开始时间,结束时间,最大记录数,导出模式,导出参数,进度指示数据对象名,取消控制数据对象名)
函数意义：
1.导出指定组对象存盘数据，导出的条件包括：开始时间-结束时间，最大导出总条数;
2.导出字段列表，组对象为MCGS_ALARM则表示导出报警历史数据；
3.可指定导出文件名和路径，主要是U盘导出，可以追加方式也可覆盖方式导出；
4.可显示导出过程进度情况；
5.可取消和中止长时间的导出过程；
6.导出格式为csv文件，导出的第一行为字段名字。
返 回 值：开关型。
发表评论