昆仑通态脚本

更新时间：2024-01-13 20:24:01 阅读量：教育文库文档下载

说明：文章内容仅供预览，部分内容可能不全。下载后的文档，内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的，是否完整无缺。

相关内容

回首页

数据对象操作函数

!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：数据对象名。

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文件，导出的第一行为字段名字。

返回值：开关型。

返回1 指定组对象错误，可能组对象没有保存历史数据或者没有该

组对象

返回2 指定的时间格式错误

返回3 指定的无效的数据对象名返回4 无效的导出模式

返回5 同时只能支持一个csv导出

参数：

文件名：字符型，指定导出的文件绝对路径名，指定的第一级目录不能创

建，其子目录如果不存在则可以创建。这样避免U盘不存在时创建U盘目录。注意：第一级目录不能自动创建用户必须保证其存在；

组对象名：导出的组对象名字。

字段名：字符型，用逗号分隔的要导出的字段名，不需要指定时间字段，

默认第一二个字段就为记录时间字段。如果为空字符串则导出所有字段。

开始时间，结束时间：用表示的时间字符串 “YYYY-MM-DD HH：MM：

SS”；

最大记录数：希望导出的最大记录数，超过该记录数就返回，停止导出；导出模式：“1”表示覆盖现有文件，“2”表示追加到文件最后；导出参数：暂时为空，保留以后使用；

进度指示数据对象名：开关型数据对象，导出过程中该对象值反映出当前

已导出记录条数，如果导出过程中其他异常结束则通过该对象返回同函数返回错误码；

进度指示错误码：

返回-1------文件不能打开返回-2------没有可导出的数据返回-4------文件操作出现错误

控制数据对象名：指定一个开关型数据对象,该对象控制导出执行，启动

导出时会自动设置该变量为0，用户在导出过程中想取消导出则可以设置该值为<0的任何值，导出函数运行结束后会自动设置对象值为1；

进度指示错误码：

返回0------导出成功返回-1-----导出路径不存在

返回1------指定组对象错误，可能组对象没有保存历史数据或者没有该组对象返回2------指定的时间格式错误

返回3------指定的无效的数据对象名返回4------无效的导出模式

返回5------同时只能支持一个csv导出

实

例

ret=

!ExportHisDataToCSV(\

harddisk\\yang.csv\进度,控制)

!GetAlmValue(DatName,Value,Flag)

函数意义：读取数据对象DatName报警限值，只有在数据对象DatName的“允许

进行报警处理”属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用Flag来标识读取何种报警限值。

返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参数：DatName：数据对象名。

Value：DataName的当前的报警限值，数值型。 Flag：数值型，标志要读取何种限值，具体意义如下：

=1下下限报警值； =2 下限报警值； =3 上限报警值； =4 上上限报警值； =5 下偏差报警限值； =6 上偏差报警限值； =7 偏差报警基准值；

实例:!GetAlmValue(电机温度,Value,3)，读取数据对象“电机温度”的报警上限值，

放入数值型数据对象Value中。

!GetEventDT()

函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。

!GetEventP()

函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。

!GetEventT()

函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。

!GroupGetInt (组对象变量,成员编号,返回值)

函数意义：读取组对象中指定的开关型成员变量的值。返回值：开关型，

返回0：执行成功；返回1：类型不匹配；

返回2：指定编号超出组对象索引范围；