当前位置:首页 >> 机械/仪表 >>

昆仑通态脚本


相关内容

回首页

数据对象操作函数

!AnswerAlm(DatName) 函数意义:应答数据对象 DatName 所产生的报警。如对应的数据对象没有报警产 生或已经应答,则本函数无效。 返 回 值:数值型,=0 为操作成功,<>0 为操作失败。 参 实 数:DatName,数据对象名。 例:!Answ

erAlm(电机温度),应答数据对象“电机温度”所产生的报警。

!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("\usb

harddisk\yang.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 的当前的报警限值,数值型。 Flag:数值型,标志要读取何种限值,具体意义如下: =1 下下限报警值; =2 下限报警值; =3 上限报警值; =4 上上限报警值; =5 下偏差报警限值; =6 上偏差报警限值; =7 偏差报警基准值; 实 例:!GetAlmValue(电机温度,Value,3), 读取数据对象“电机温度”的报警上限值, 放入数值型数据对象 Value 中。 !GetEventDT() 函数说明:此函数在嵌入版中无效,考虑兼容性问题,故保留。 !GetEventP() 函数说明:此函数在嵌入版中无效,考虑兼容性问题,故保留。 !GetEventT()

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

!GroupGetInt (组对象变量,成员编号,返回值)
函数意义:读取组对象中指定的开关型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配; 返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 返回值,开关型,保存返回的值。 实 例:Ret=!GroupGetInt(Group,0,Int)。

!GroupGetFloat(组对象变量,成员编号,返回值) 函数意义:读取组对象中指定的数值型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配; 返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 返回值,数值型,保存返回的值。 实 例: Ret=!GroupGetFloat(Group,0,Float)。

!GroupGetString(组对象变量,成员编号,返回值) 函数意义:读取组对象中指定的字符型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配;

返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 返回值,字符型,保存返回的值。 实 例: Ret=!GroupGetString(Group,0,String)。

!GroupSetInt (组对象变量,成员编号,设置值) 函数意义:设置组对象中指定的开关型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配; 返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 设置值,开关型,要设置的值。 实 例: Ret=!GroupSetInt (Group,0,Int)。

!GroupSetFloat(组对象变量,成员编号,设置值) 函数意义:设置组对象中指定的数值型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配; 返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 设置值,数值型,要设置的值。 实 例: Ret=!GroupSetFloat(Group,0,Float)。

!GroupSetString(组对象变量,成员编号,设置值)

函数意义:设置组对象中指定的字符型成员变量的值。 返 回 值:开关型, 返回 0:执行成功; 返回 1:类型不匹配; 返回 2:指定编号超出组对象索引范围; 返回 3:指定组对象不存在或指定变量不是组对象。 参 数: 组对象变量,组对象类型。 成员编号,开关型,成员变量在组对象中的编号,从 0 开始。 设置值,字符型,要设置的值。 实 例: Ret=!GroupSetString(Group,0,String)。

!MoveSaveDat() 函数说明:此函数在嵌入版中无效,考虑兼容性问题,故保留。 !SaveData(DatName) 函数意义:把数据对象 DataName 对应的当前值存入存盘数据库中。本函数的操作 使对应的数据对象的值存盘一次。此数据对象必须具有存盘属性,且 存盘时间需设为 0 秒。否则会操作失败。 返 回 值:数值型,=0 为操作成功,<>0 为操作失败。 参 实 数:DatName,数据对象名。 例: !SaveData(电机 1), 把组对象“电机 1”的所有成员对应的当前值存盘一次。

!SaveDataInit() 函数说明:此函数在 McgsE7.6(03.0001)及以后版本中无效,考虑兼容性问题, 故保留。 !SaveDataOnTime(Time,TimeMS,DataName) 函数意义:使用指定时间保存数据。本函数通常用于指定时间来保存数据,实现与 通常机制不一样的存盘方法。 返 回 值:数值型,返回值=0:调用正常,<>0:调用不正常。 参 数:Time,数值型,使用时间函数转换出的时间量。时间精度到秒。 TimeMS,数值型,指定存盘时间的毫秒数。



例:t =!TimeStr2I("2001 年 2 月 21 日 3 时 2 分 3 秒");!SaveDataOnTime (t,0,DataGroup), 按照指定时间保存数据对象。

!SaveSingleDataInit(Name)

函数意义:本操作把数据对象的当前值设置为初始值(不管该对象是否设置有“退 出时自动保存数据对象的当前值作为初始值”属性),防止突然断电而 无法保存, 以便 MCGS 嵌入版下次启动时这些数据对象能自动恢复其 值。 返 回 值:数值型,返回值=0:调用正常,<>0:调用不正常。 参 实 数:Name,数据对象名。 例:!SaveSingleDataInit(温度),把温度的当前值设置成初始值。

!SetAlmValue(DatName,Value,Flag)

函数意义:设置数据对象 DatName 对应的报警限值,只有在数据对象 DatName“允 许进行报警处理”的属性被选中后, 本函数的操作才有意义。 对组对象、 字符型数据对象、事件型数据对象本函数无效。对数值型数据对象, 用 Flag 来标识改变何种报警限值。 返 回 值:数值型,返回值=0:调用正常,<>0:调用不正常。 参 数:DatName:数据对象名。 Value:新的报警值,数值型。 Flag:数值型,标志要操作何种限值,具体意义如下: =1 下下限报警值; =2 下限报警值; =3 上限报警值; =4 上上限报警值; =5 下偏差报警限值; =6 上偏差报警限值; =7 偏差报警基准值; 实 例:!SetAlmValue(电机温度,200,3),把数据对象“电机温度”的报警上限值设 为 200

!TransToUSB(组对象名,起始时间,结束时间,导出状态,进度指示,转出模式,保留参数)

函数意义:将 XXX 组对象的存盘数据导出到"USB HARDDISK"目录下,保存为 “XXX.csv”文件,模拟环境则是保存到与可执行文件相同路径下。 返 回 值:开关型。 0:参数没有错误。 1: 第一个参数错误。 (请检查是否组对象名称, 或“MCGS_ALARM”) 2: 时间参数格式错误。 3:状态变量的类型错误。(两个变量都必须是开关量) 5:同时只能支持一个 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-12-31 00:00:00 , Switch01 , Switch02 , 0 , "")。 注意事项:

该函数最多只能导出 30000 条记录。当满足导出时间条件的记录数大 于 30000 时,只导出前 30000 条记录。

!CopyDateFileToDisk(pathName,dataType,copyState) 函数意义: 拷贝当前运行工程的数据到指定的目录 pathName 中。 返 回 值: 1:在拷贝的过程中,数据对象 copyState,由 0 转变为非 0.表示用户不想 继续拷贝。 0:表示拷贝成功。 -1:当前工程中,当前运行工程中没有组对象要存盘。 -2:创建目录 pathName 失败。 -3:创佳索引文件 MCGS_DATA.ini 失败或者对此文件进行写操作失 败。 -4:参数 dataType 的值,不正确,目前只支持值为 0。 -5:磁盘空间不足。 -6:参数 copyState 不是数据对象类型。 -7:参数 copyState 是数据对象类型,但不是开关型数据对象。 -8:参数 copyState 在一开始调用此脚本时,就为非 0。 参数说明: pathName:字符串型.要拷贝数据到此的路径名.例如:在模拟环境可以 写"d:\test",在运行环境可写"harddisk\test"。 dataType:开关型.拷贝数据的类型,0 表示历史数据,1 表示报警数据.目 前只支持拷贝历史数据,报警数据还没有处理。 copyState:数据对象型.是否拷贝的标志.当为 0 表示可以拷贝,为非 0 表示取消当前的拷贝。



例:!CopyDateFileToDisk("harddisk\test",0,copyState) 把当前工程中历史数据 拷贝到目录"harddisk\test"中(如 copyState 为 0 表示拷贝,为非表示取消)。



明:一般此脚本要配合组态环境中的一个小程序 DataTrans.exe 来一起操作. 把拷贝的数据目录,通过 U 盘或其他方式,导到上位机(PC),通过用程序 DataTrans.exe 来进行数据的转换。

回到顶部


相关文章:
昆仑通态脚本
昆仑通态脚本_机械/仪表_工程科技_专业资料。相关内容 回首页 数据对象操作函数 !AnswerAlm(DatName) 函数意义:应答数据对象 DatName 所产生的报警。如对应的数据...
昆仑通态脚本开发函数
昆仑通态脚本开发函数_计算机软件及应用_IT/计算机_专业资料。MCGS脚本开发函数 !GetCurrentChannelNum() 函数意义:得到当前触发单通道写的通道号; 返回值:整型。-...
昆仑通态触摸屏软件使用方法
昆仑通态触摸屏软件使用方法_计算机软件及应用_IT/计算机_专业资料。昆仑通态触摸屏软件使用方法一、启动软件 图一 二、新建工程(工程是用户应用系统的简称。引入...
昆仑通态触摸屏教程服务宝典
该组态工程为我公司用北京昆仑通态MCGS软件开发,版权为我公司所有,而 与此产生...定制环境可以到www.mcgs.com.cn 的“下载中心-定制版 本”里下载脚本驱动开发...
mcgs脚本驱动
mcgs脚本驱动_电子/电路_工程科技_专业资料。北京昆仑通态自动化软件科技有限公司 脚本驱动 V2.0 使用指导手册版本号:0.1 -1- 北京昆仑通态自动化软件科技有限公...
昆仑通态连打印机样例说明
昆仑通态连打印机样例说明_电子/电路_工程科技_专业资料。示例使用的相关环境和...调用脚本函数!SetWindow()打印所指定的工程窗口。如图: 3 第二种方法是利用...
MCGS脚本程序
? ? ? 在“运行策略”中的“脚本程序”构件中使用; 在“菜单”属性设置中的“脚本程序”中使用,作为菜单的一个辅助功 能运行; 在“用户窗口”属性设置中的“...
昆仑通态触摸屏设置开机密码的方法
昆仑通态触摸屏设置开机密码的方法_教学反思/汇报_教学研究_教育专区。昆仑通态触摸屏设置开机密码的方法 1、 打开设备窗口,设置 2、 3、 4、 5、 打开运行...
工控系统安装与调试教案水位控制(昆仑通态)
工控系统安装与调试教案水位控制(昆仑通态)_工学_高等教育_教育专区。常州纺织...水位控制工程脚本程序编写 学期 计划学时 2 教学目的 知识要点 1、掌握组态工程...
MCGS脚本驱动开发工具使用指导手册
MCGS脚本驱动开发工具使用指导手册_IT/计算机_专业资料。MCGS的脚本驱动开发工具使用指导手册 北京昆仑通态自动化软件科技有限公司 脚本驱动 V2.0 使用指导手册版本号:...
更多相关标签:
昆仑通态脚本教程 | 昆仑通态脚本程序 | 昆仑通态 | 昆仑通态脚本怎么写 | 昆仑通态触摸屏脚本 | 昆仑通态脚本语言 | 昆仑通态窗口跳转脚本 | 昆仑通态脚本使用手册 |