!ExportHisDataToCSV(文件名,组对象名,字段名,开始时间,结束时间,最大记录数,导出模式,导出参数,进度指示数据对象名,控制数据对象名)
函数意义: 以CSV格式导出指定时间段的历史存盘数据或历史报警数据到U盘,csv文件的第一行是对应的字段名
(1)指定导出的文件绝对路径名,以U盘根目录开始的目录,不存在子目录时创建
(2)导出字段列表,组对象名为“Mcgs_HistoryAlarm”时导出历史报警数据,组对象名为”MCGS_OPERATION_LOG”导出操作日志
(3)可指定导出文件名和路径,主要是U盘导出,可以追加方式也可覆盖方式导出
(4)可显示导出过程进度情况
(5)可取消和中止长时间的导出过程
(6)导出格式为csv文件,导出的第一行为字段名字
参 数:
(1)文件名,字符串,指定导出的文件绝对路径名,目录不存在时自动创建,支持以”$MCGS_DIR_USER”开头的路径,表示导出到用户分区,其它不指定则为U盘
(2)组对象名,字符串,导出的组对象名字、“Mcgs_HistoryAlarm”或”MCGS_OPERATION_LOG”
(3)字段名:字符串,用逗号分隔的要导出的字段名,每条记录都包含时间字段:MCGS_TIME,以及毫秒时间:MCGS_TIMEMS。如果字符串内容为空字符串””,则导出所有字段,报警数据没有应答或结束报警时,对应的秒字段为空
(4)(5)开始时间,结束时间:字符串,表示的时间字符串 “YYYY-MM-DD HH:MM:SS”或“YYYY/MM/DD HH:MM:SS”
(6)最大记录数:整数,希望导出的最大记录数,超过该记录数就返回,停止导出,如果为0,则只导出存盘的字段名
(7)导出模式:整数
=1,表示覆盖现有文件
=2,表示追加到文件最后
(8)导出参数:字符串,暂时为空,保留以后使用
(9)进度指示数据对象名:必须为整数数据对象,导出过程中该对象值反映出当前已导出记录条数,如果导出过程中其他异常结束则通过该对象返回同函数返回错误码
(10)进度指示错误码:
= -1001,进度或控制数据对象类型不正确
= -1004,组对象名不存在或组对象不具有存盘属性
= -1020,导出的开始时间大于结束时间
= -1021,U盘没有插入
= -1022,同一时间只允许一个导出任务
= -1023, 记录读取的条数为0
= -1024, 文件操作失败
= -1025, 导出路径为空
= -1026, 导出路径不合法
= -1027, 时间格式不正确
= -1028, 不支持的导出模式
(11)控制数据对象名:指定一个整数数据对象,该对象控制导出执行,启动导出时会自动设置该数据对象为0,用户在导出过程中想取消导出则可以设置该值为<0的任何值,导出函数运行结束后会自动设置对象值为1
返 回 值: 整数
= 0 ,调用成功
<> 0,调用失败
= -1001,进度或控制数据对象类型不正确
= -1004,组对象名不存在或组对象不具有存盘属性
= -1020,导出的开始时间大于结束时间
= -1021,U盘没有插入
= -1022,同一时间只允许一个导出任务
= -1023,记录读取的条数为0
= -1024,文件操作失败
= -1025,导出路径为空
= -1026,导出路径不合法
= -1027,时间格式不正确
= -1028,不支持的导出模式
实 例: Ret= !ExportHisDataToCSV("test/yang.csv","group","data1,data4","2016/6/1 0:0:0","2016/6/30 0:0:0",20000,1,"",进度,控制),执行成功,将组对象group中data1和data4在2016/6/1 0:0:0到2016/6/30 0:0:0时间段内的存盘数据导出至U盘,保存到/test/yang.csv文件中,如果该时间段内无数据,则进度指示返回0,控制为1,Ret=0
函数意义: 以CSV格式导出指定时间段的历史存盘数据或历史报警数据到U盘,csv文件的第一行是对应的字段名
(1)指定导出的文件绝对路径名,以U盘根目录开始的目录,不存在子目录时创建
(2)导出字段列表,组对象名为“Mcgs_HistoryAlarm”时导出历史报警数据,组对象名为”MCGS_OPERATION_LOG”导出操作日志
(3)可指定导出文件名和路径,主要是U盘导出,可以追加方式也可覆盖方式导出
(4)可显示导出过程进度情况
(5)可取消和中止长时间的导出过程
(6)导出格式为csv文件,导出的第一行为字段名字
参 数:
(1)文件名,字符串,指定导出的文件绝对路径名,目录不存在时自动创建,支持以”$MCGS_DIR_USER”开头的路径,表示导出到用户分区,其它不指定则为U盘
(2)组对象名,字符串,导出的组对象名字、“Mcgs_HistoryAlarm”或”MCGS_OPERATION_LOG”
(3)字段名:字符串,用逗号分隔的要导出的字段名,每条记录都包含时间字段:MCGS_TIME,以及毫秒时间:MCGS_TIMEMS。如果字符串内容为空字符串””,则导出所有字段,报警数据没有应答或结束报警时,对应的秒字段为空
(4)(5)开始时间,结束时间:字符串,表示的时间字符串 “YYYY-MM-DD HH:MM:SS”或“YYYY/MM/DD HH:MM:SS”
(6)最大记录数:整数,希望导出的最大记录数,超过该记录数就返回,停止导出,如果为0,则只导出存盘的字段名
(7)导出模式:整数
=1,表示覆盖现有文件
=2,表示追加到文件最后
(8)导出参数:字符串,暂时为空,保留以后使用
(9)进度指示数据对象名:必须为整数数据对象,导出过程中该对象值反映出当前已导出记录条数,如果导出过程中其他异常结束则通过该对象返回同函数返回错误码
(10)进度指示错误码:
= -1001,进度或控制数据对象类型不正确
= -1004,组对象名不存在或组对象不具有存盘属性
= -1020,导出的开始时间大于结束时间
= -1021,U盘没有插入
= -1022,同一时间只允许一个导出任务
= -1023, 记录读取的条数为0
= -1024, 文件操作失败
= -1025, 导出路径为空
= -1026, 导出路径不合法
= -1027, 时间格式不正确
= -1028, 不支持的导出模式
(11)控制数据对象名:指定一个整数数据对象,该对象控制导出执行,启动导出时会自动设置该数据对象为0,用户在导出过程中想取消导出则可以设置该值为<0的任何值,导出函数运行结束后会自动设置对象值为1
返 回 值: 整数
= 0 ,调用成功
<> 0,调用失败
= -1001,进度或控制数据对象类型不正确
= -1004,组对象名不存在或组对象不具有存盘属性
= -1020,导出的开始时间大于结束时间
= -1021,U盘没有插入
= -1022,同一时间只允许一个导出任务
= -1023,记录读取的条数为0
= -1024,文件操作失败
= -1025,导出路径为空
= -1026,导出路径不合法
= -1027,时间格式不正确
= -1028,不支持的导出模式
实 例: Ret= !ExportHisDataToCSV("test/yang.csv","group","data1,data4","2016/6/1 0:0:0","2016/6/30 0:0:0",20000,1,"",进度,控制),执行成功,将组对象group中data1和data4在2016/6/1 0:0:0到2016/6/30 0:0:0时间段内的存盘数据导出至U盘,保存到/test/yang.csv文件中,如果该时间段内无数据,则进度指示返回0,控制为1,Ret=0