MCGS--U盘导出TPC7062ti

青旅半醒 2023-06-18 15:53 5阅读 0赞

!ExportHisDataToCSV(文件名,组对象名,字段名,开始时间,结束时间,最大记录数,导出模式,导出参数,进度指示数据对象名,控制数据对象名)  
函数意义：1.导出指定组对象存盘数据，导出的条件包括：开始时间-结束时间，最大导出总条数

2.导出字段列表，组对象为MCGS_ALARM则表示导出报警历史数据
    
          3.可指定导出文件名和路径，主要是U盘导出，可以追加方式也可覆盖方式导出
    
          4.可显示导出过程进度情况
    
          5.可取消和中止长时间的导出过程
    
          6.导出格式为csv文件，导出的第一行为字段名字

返 回 值：开关型

返回 = 1，指定组对象错误，没有该组对象
    
          返回 = 2，指定的时间格式错误
    
          返回 = 3，指定的无效的进度指示和取消控制数据对象名
    
          返回 = 4，无效的导出模式
    
          返回 = 5，同时只能支持一个csv导出

参 数：文件名，字符型，指定导出的文件绝对路径名，指定的第一级目录不能创建，其子目录如果不存在则可以创建。这样避免U盘不存在时创建U盘目录。注意：第一级目录不能自动创建用户必须保证其存在

组对象名，字符型，导出的组对象名字或“MCGS_ALARM”
    
          字段名，字符型，用逗号分隔的要导出的字段名，不需要指定时间字段，默认第一二个字段就为记录时间字段。如果为空字符串则导出所有字段。如果导出报警数据（组对象名“MCGS_ALARM”），字段名必须为空
    
          开始时间、结束时间，字符型，用于表示的时间字符串 “YYYY-MM-DD HH：MM：SS”或者“YYYY/MM/DD HH：MM：SS”
    
          最大记录数，开关型，希望导出的最大记录数，超过该记录数就返回，停止导出，如果为0或负数，就只导出存盘的第一条记录
    
          导出模式，开关型：
    
              导出模式 = 1，表示覆盖现有文件
    
              导出模式 = 2，表示追加到文件最后
    
          导出参数，字符型，暂时为空，保留以后使用
    
          进度指示数据对象名，必须为开关型数据对象，导出过程中该对象值反映出当前已导出记录条数，如果导出过程中其他异常结束则通过该对象返回进度指示错误码：
    
              进度指示 = -1，表示文件不能打开或者导出路径不存在
    
              进度指示 = -2，表示没有可导出的数据或者设置的时间段内无数据
    
              进度指示 = -4，表示文件操作出现错误
    
          控制数据对象名，指定一个开关型数据对象,该对象控制导出执行，启动导出时会自动设置该变量为0，用户在导出过程中想取消导出则可以设置该值为<0的任何值，导出函数运行结束后会自动设置对象值为1

实 例: ret = !ExportHisDataToCSV("\\usbharddisk\\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盘，保存到yang.csv文件中，最大导出记录数20000，如果实际存盘数据记录小于20000，导出实际存盘记录，如果大于20000，则只导出前20000条记录；如果该时间段内无数据，则进度指示返回-2，ret = 0

注意事项：1.组对象名必须与工程实际存在的组对象名完全一致

2.字段名必须与组对象存在的成员变量名完全一致

注意事项：  
1、变量的类型一定要按照函数的参数类型设置。  
2、存盘的存盘周期设置为大于0则按照设置进行求和，如果设置成0，则按照!SaveData(曲线显示组对象)函数的执行为准。