WinCC报表控件实战：从变量归档到VBS脚本导出Excel

简介WinCC报表控件是西门子WinCC V7.x与博途WinCC环境下高效生成生产数据报表的工具面向自动化工程师和PLC调试人员旨在简化实时/历史数据的可视化与报告输出流程无需编写复杂脚本即可配置出专业美观的报表。该压缩包共15个文件大小约10.94MB内含5个dll动态库核心控件与数据接口、exe可执行程序、pdf使用手册、mp4入门操作视频、png示例图片及xml/ini配置文件等结构清晰便于部署参照。已有6755人学习过该资源。包内提供的WinCCDataReport V35.0程序、操作录屏与详细手册可帮助用户快速搭建报表环境掌握动态数据绑定、多类型图表配置、定时/触发生成、打印导出及报警集成等核心功能有效提升日常监控与数据分析效率。对于正在实施WinCC项目或希望优化报表开发流程的工程师这是一份可直接上手并反复查阅的实用资料。1. WinCC报表控件从“数据能看”到“数据能交差”的那一步做WinCC项目的工程师基本都经历过这个阶段画面上的趋势、表格、报警都跑得挺好操作员也认可结果某天生产经理过来说“给我弄张日报表把今天每小时的温度、压力、产量打出来”。这时候你才发现报表控件不是画面上拖一个控件那么简单它牵扯到变量归档、时间筛选、打印格式、导出Excel这一整条链路。这篇笔记我把WinCC报表控件的选型思路、配置步骤、脚本写法和几个典型坑完整过一遍覆盖TIA平台和经典WinCC的通用做法新手照着能把第一张报表跑起来老手重点看参数边界和排错顺序。2. 报表控件的四种实现方式先选型再动手2.1 表格控件固定格式数据表的最快路径WinCC自带的表格控件TableControl是所有报表需求里优先级最高的候选方案。它的本质是一个ActiveX控件直接绑定运行系统中的变量或者归档数据源不需要写一行代码就能把实时值、历史值按行显示出来。它的优势在于和WinCC运行环境天然集成画面打开就能看到数字支持时间范围筛选支持按列排序打印时走WinCC的打印管理器页面设置统一。适合用表格控件的场景有三个特征格式固定、数据量中等、不需要复杂统计。比如设备的每日温度记录表一行一条数据列就是“时间、温度、压力、状态”这种需求用表格控件十分钟就能搭完。但如果你要的是一张带合计、平均、最大值标注的报表表格控件自己做不到得靠脚本去算这时就该考虑后面几种方式了。2.2 趋势控件当半报表曲线回看和采样对齐有些“报表”其实是曲线领导要看的不是数字是趋势走向。WinCC的趋势控件TrendControl可以用来做半报表最常见的是把24小时内的流量曲线打出来方便对比前后班次的波动。趋势控件支持多条曲线叠加时间轴可以缩放光标能读取当前值。用趋势控件做报表有个隐藏优势它天然处理了采样对齐问题。归档数据往往是不均匀的变量动作频繁时记录多平稳时记录少表格显示出来会一节一节的难比对。趋势控件按时间轴绘制数值稀疏时自动连线这种场景下比表格直观得多。但趋势控件的导出能力弱想导出成Excel基本只能截屏所以我的习惯是给操作员看的实时报表用趋势控件给管理层交差的文本报表用表格或Excel。2.3 报表系统与脚本导出打印级报表的正路当需求上升到“每天8点自动打印前一天的班报表带公司抬头、带页脚、带审核签名栏”原生控件的短板就暴露了。这时候正路有两条。一条是WinCC Professional版本的报表系统它自带报表编辑器可以设计固定样式的打印模板把归档变量、系统时间、操作员姓名这些字段拖拽到模板上设定定时打印任务。这套东西的好处是打印样式专业坏处是版本授权门槛高、设计器用起来需要适应很多项目组用了不到三分之一的功能就转去脚本了。另一条是VBS脚本导出Excel。这是绝大多数项目里最终采用的路径因为它绕开了WinCC打印系统的页面约束把数据交给Excel去排版。关于这条路径的操作细节第4章会展开讲。2.4 选型对照与决策建议实现方式定时自动出表时间范围筛选打印质量数据统计能力维护成本适用阶段表格控件支持但配置繁琐支持游标区间一般无低在线查看趋势控件支持支持一般无低曲线对比报表系统原生支持支持高弱中正式打印VBS脚本导出Excel支持脚本控制高强高交差报表优先顺序我一般这样定先确认交付形式屏幕看还是纸上看再看要不要定时最后看要不要统计函数。如果只是屏幕上点按钮看某个时间段的历史数据用表格控件加一个时间筛选就够了没必要上脚本。如果涉及跨班次汇总、平均值、合格率这类计算请直接进入第3章把归档配好同时准备第4章的Excel脚本两条腿走路。3. 核心实现把归档数据装进表格控件3.1 归档配置报表的数据地基所有报表都建立在一件事上变量发生过什么历史记录。WinCC里这块叫变量归档经典WinCC的Tag Logging或数据记录TIA平台的Data Logging。很多时候表格控件查出空数据不是控件没配好而是归档根本没启动。归档配置的通用逻辑分三步。第一步建立记录变量把需要出现在报表里的物理量全部加进去比如反应釜温度、夹套压力、循环水流量。第二步设定采集周期这个参数直接决定报表的粒度默认是1秒或1分钟我的建议是普通过程量按“变化时归档”或者1分钟周期即可不要无脑选1秒否则一天的报表会有八万多行数据查询和打印都拖垮。第三步勾选“启动采集”然后在运行环境激活归档这一步非常容易被忘记尤其是TIA平台里新增数据记录后没有重新激活。除了周期还有两个参数会影响报表准确性采集死区和归档死区。采集死区是变量值变化多少才写入归档死区是变化的百分比阈值。现场压力变送器在小范围波动时如果死区设小了归档里会堆满无效波动数据设大了真实的小幅变化被过滤掉报表曲线变成一条直线。经验值是0.5%到1%之间起步确认现场波动后微调。3.2 表格控件的三处关键参数数据源、时间范围、刷新方式表格控件拖到画面上之后属性面板里有三处是必须挨个过一遍的。第一处是数据源表格控件支持两种模式实时模式和归档模式做报表必须切到归档数据源否则你只能看到当前值看不到历史。第二处是时间范围表格控件通常提供“起始时间”和“结束时间”属性可以直接填固定时间也可以绑定内部变量实现运行期修改。第三处是刷新方式默认是手动刷新也就是必须在脚本里调刷新方法或属性数据才会按最新筛选条件重新加载。常见的错误是把时间范围写死在属性里结果画面跑了一个月报表还是那几天的数据。对应做法是规划两个内部变量例如ReportStartTime和ReportEndTime在画面打开时或者按钮点击时通过脚本写入DateTime值再把表格控件的时间属性绑定到这两个变量上。这样每次刷新按钮一按控件自动按新区间查询。3.3 定时出表用计划任务或内部变量触发很多项目要求“早上8点自动生成昨天的报表”这时候触发方式有两个选择。经典WinCC有自带的定时任务在脚本触发器的界面里添加“每日”触发器设定执行时间和执行脚本脚本里重算时间范围并刷新控件。TIA平台的HMI脚本触发器一样可以做但界面上叫法不同常见的是在“计划任务”里新增任务事件类型选“每日/每周/每月”再绑定脚本。如果不想用计划任务还有一个土办法画面放一个隐藏的按钮用一个周期1秒的内部变量计数到设定时刻触发按钮事件里的报表生成脚本。这个方式的好处是逻辑完全透明排错的时候直接看变量值就知道触发没触发缺点是占一个周期变量而且WinCC的脚本执行优先级不如系统任务高峰时段可能延迟个几秒。对于报表这种早几分钟晚几分钟都无所谓的场景完全够用。3.4 VBS脚本实例刷新报表并重置时间范围下面这段脚本是在按钮事件里写的最典型的刷新过程它做了两件事把时间范围指向“昨天零点到今天零点”然后触发表格控件重新加载数据。Dim startTime, endTime 计算昨天零点 startTime DateSerial(Year(Now), Month(Now), Day(Now) - 1) 计算今天零点 endTime DateSerial(Year(Now), Month(Now), Day(Now)) 写入内部变量表格控件的时间属性绑定到这两个变量 SmartTags(ReportStartTime) CDate(startTime 00:00:00) SmartTags(ReportEndTime) CDate(endTime 00:00:00) 刷新表格控件不同版本写法略有差异 ScreenItems(ReportTable).Refresh逻辑说明DateSerial是VBScript里最可靠的日期偏移函数直接传年月日三个参数Day(Now)-1就是昨天的日期避开跨月、跨年时手工算日期的麻烦。SmartTags是读写WinCC内部变量的标准入口这里要求表格控件的起始时间属性绑定的是ReportStartTime这个变量绑定关系在控件属性里提前配置好。Refresh方法在经典WinCC和TIA里都存在但部分版本要求写ScreenItems(ReportTable).OutputUS或类似属性如果你的版本里Refresh报错先确认控件的对象名是否正确再查这个版本控件提供的方法清单。参数说明这段脚本没有处理跨年因为DateSerial会自动处理年份进位12月31日的昨天会正确算成12月30日1月1日的昨天会算成上年12月31日这是DateSerial比DateAdd更直观的地方。如果你要做“前七天”这样的区间把Day(Now)-1换成Day(Now)-7即可月份和年份自动进位不需要额外判断。3.5 数据量大的时候要分页日报表的默认粒度是1分钟一天1440行表格控件加载没有问题。但如果有人要求“把过去三个月每分钟的数据都打出来”那就是十三万行表格控件直接在运行画面里卡死重则整个HMI页面白屏。这种场景不能靠表格控件硬撑备选方案有两个。一个是按天切割查询报表界面留一个日期选择框一天一查查询脚本只处理当天数据另一个是走SQL直接查归档数据库用分页查询或者汇总查询把结果按小时聚合只返回平均值和极值数据量从13万行降到几百行。后面这个思路的实际价值很大后面第6章的班报表就是按时间聚合思路展开的。4. 打印与导出从屏幕到纸面与Excel4.1 导出Excel的三种路径WinCC里导出Excel的需求几乎每个项目都会遇到路径主要有三条。第一条是表格控件自带的导出功能不少版本的表格控件在右键菜单里带“导出CSV”或“复制表格”选项CSV可以直接被Excel打开缺点是格式需要重新整理而且只能导出控件当前显示的内容数据行数多了会截断。第二条是VBS创建Excel对象这是最通用也最灵活的路脚本先把数据写入Excel单元格再按需设置边框、字体、合并单元格最后另存为xlsx文件。第三条是CSV中转脚本把数据写成CSV文本文件再用Excel打开另存。这条路径在服务器没有安装Excel的场合很有用因为WinCC脚本启动Excel需要本机装了Office没装就创建对象失败CSV中转则不需要。### 4.2 VBS脚本导出Excel按模板写数据的常见写法 vbscript Dim objExcel, objSheet, objRow Dim i, fileName 创建Excel对象 Set objExcel CreateObject(Excel.Application) objExcel.Visible False objExcel.DisplayAlerts False 新工作簿 Set objSheet objExcel.Workbooks.Add.Worksheets(1) objSheet.Name 班次报表 表头 objSheet.Cells(1, 1).Value 时间 objSheet.Cells(1, 2).Value 温度(℃) objSheet.Cells(1, 3).Value 压力(MPa) objSheet.Cells(1, 4).Value 状态 objRow 2 从归档查询结果循环写入 For i 0 To UBound(arrResult) objSheet.Cells(objRow, 1).Value arrResult(i, 0) objSheet.Cells(objRow, 2).Value arrResult(i, 1) objSheet.Cells(objRow, 3).Value arrResult(i, 2) objSheet.Cells(objRow, 4).Value arrResult(i, 3) objRow objRow 1 Next 保存文件文件名带日期时间 fileName D:\Reports\ Year(Now) Month(Now) Day(Now) _ Hour(Now) Minute(Now) .xlsx objSheet.SaveAs fileName objExcel.Quit Set objSheet Nothing Set objExcel Nothing逻辑说明这段脚本的核心在CreateObject(Excel.Application)只要运行环境装了Excel这个调用就能成功。数据来源arrResult是前面从WinCC归档里查出来的二维数组实际项目里可以由SQL查询构造也可以由表格控件提供的数据源导出。行号变量objRow从第二行开始是因为第一行留给了表头这符合Excel报表的习惯。参数说明文件名拼接直接用了年月日时分没有加分隔符这样做是为了避免文件名里出现冒号等Excel不接受的字符。Year(Now) Month(Now)拼接的结果是2025137这样的数字一眼看得出日期但不好读你可以改成Year(Now) - Month(Now) - Day(Now)。想保留整数可以用FormatDateTime函数但那个函数的格式受系统区域影响跨语言版本的工控机上容易出幺蛾子不如手工拼接稳。4.3 打印模板与页面设置报表打印的坑经常不在数据而在于版式。WinCC画面自带打印功能把画面整页打印出来但表格行数多了会自动拆页拆页位置不固定相当难看。正确做法是给报表单独做一版“打印画面”这个画面不用于操作只用于打印画面长宽比设置为A4竖版或横版。页面设置里要调整三个参数打印比例建议直接缩放到适合一页宽度默认是100%行多时会超宽上下左右边距设成5到10毫米给页眉页脚留出空间打印方向根据表格列数决定超过五列就转横版。我们群里有个工程师跟我讲过他让表格跑到第三页背面、领导没看到后面数据的经历从那以后他所有的报表画面都把“适合一页宽度”写在设计说明里。打印触发可以用按钮也可以和定时报表联动。定时触发打印时WinCC的打印任务会走打印管理器队列如果现场打印机离线或卡纸任务会堆积后面正常的打印全被堵住。所以自动打印场景一定要在脚本里加一个“打印机在线状态”判断离线则弹提示或者把打印结果重定向成PDF文件。HTML的打印输出到PDF在很多版本里都支持选打印机时选系统自带的Microsoft Print to PDF即可。5. 避坑WinCC报表控件里最常见的五个问题与排查顺序报表功能上线后最折磨人的不是功能写不出来而是写出来之后某些边界时间、某些操作顺序下数据对不上。下面这五条是我在不同项目里踩过、也帮人排过的实际案例按现象、原因、解决的顺序写清楚。5.1 报表时间整体慢八小时现象报表查询区间的数据显示出来每天的数据整体偏移了8个小时左右。查询近三天数据时昨天中午的记录显示在早上四点钟。原因WinCC的变量归档时间戳默认存的是本地时间但时区设置成UTC之后归档和显示会出现时差。很多工程师在部署工控机时为了日志规范把系统时区改成了UTC而WinCC的归档服务仍然按本地Windows时间记录两边各差八小时叠加起来就出现了偏移。解决以工控机的本地时间为准不要换区。打开系统时间设置把时区改回北京时间或项目所在地时区去掉“自动设置时区”的勾选然后重启WinCC运行系统归档数据自动对齐。注意归档数据本身不用清空时间戳存的是绝对时间系统时区改回来后读取自然恢复正常。5.2 表格控件一片空白查询无数据现象表格控件绑定好了归档数据源运行画面里按筛选条件查一天的数据控件区域空白没有报错也没有数据行。原因八成是归档压根没在记录。常见情况有三种记录变量没有勾选“归档”变量采集周期设成了“只在变化时”而现场值一直保持恒定就永远没有变化自然没有数据或者TIA平台里数据记录新增之后没有激活运行。解决先查归档状态在WinCC变量管理器里找到对应记录看记录变量的“状态”列是不是“正在采集”。没有就在线激活。如果激活了还没数据把采集方式改成“周期采集”并设一个固定周期比如5秒或1分钟。改完之后旧数据不会补录要等新的周期时间过去后再验证。5.3 导出的Excel打开就报格式损坏现象VBS脚本导出xlsx文件脚本执行成功文件大小也正常但用Excel打开时弹“文件格式与扩展名不匹配”或直接打不开。原因SaveAs方法的参数没有指定文件格式。Excel的SaveAs如果不带第二个参数默认按当前版本的默认格式保存但有些Office版本在无人值守调用时会把xlsx存成XML格式或者文本格式扩展名却是xlsx导致文件头不对。解决SaveAs时显式传文件格式编号xlsx格式对应的编号是51。改成objSheet.SaveAs fileName, 51。如果是在老Office环境xls对应的是56根据现场装的版本选一个。这个参数值不同版本有些区别装完Excel先在开发环境手动验证一次再下发画面。5.4 查询大时间段控件卡死现象操作员点了一个月的时间范围表格控件转圈十几秒画面失去响应严重的直接退出运行系统。原因表格控件一次性加载了全部查询结果归档数据里有几万甚至十几万行控件渲染时内存飙升加上运行环境本来就在实时刷新其他画面元素CPU被打满。解决限制单次查询的数据量上限。实现方式主要有两种一种是在查询逻辑里按天循环一天查一次每次加载完把数据二次处理另一种是改用SQL聚合查询把分钟级数据按小时取平均值和极值报表展现小时粒度就足够把数据库的压力降下来。数据量硬需求超过五万行的场景建议彻底放弃表格控件走SQL加Excel导出。5.5 打印报表时页边距和画面预览不一致现象画面预览时表格正好一页打印出来却左右缺了一块右边列被截掉。原因WinCC画面的显示分辨率与实际打印机分辨率不一致画面设计时用的是1920×1080工作站操作站的打印机是老旧针打或驱动异常打印比例又不匹配。解决打印专用画面的页面设置里把缩放方式从“实际大小”改为“缩放以适应纸张”纸张类型选A4。同时设计打印画面时只放报表相关的内容宽度最好不超过800像素A4竖版这样在大多数打印机上都能完整输出。如果现场有多台不同品牌打印机测试时每台都打一份样张。6. 把报表做成班报时间参数联动与边界验证报表做到最后最常被点名要的是班报早班、中班、夜班每班一张。我一般把实现拆成三个组件班次配置表、时间区间计算脚本、和一张带筛选条件的存根画面。班次配置表用内部变量存班次开关时间比如早班是8点到16点中班是16点到0点夜班是0点到8点。在画面里用下拉列表控件选班次脚本里根据当前选中的班次索引去算起始时间和结束时间然后把这两个时间写进归档查询。核心代码如下Dim shiftIdx, startTime, endTime shiftIdx SmartTags(CurrentShiftIndex) 0早班(08:00-16:00)1中班(16:00-00:00)2夜班(00:00-08:00) Select Case shiftIdx Case 0 startTime DateSerial(Year(Now), Month(Now), Day(Now)) 08:00:00 endTime DateSerial(Year(Now), Month(Now), Day(Now)) 16:00:00 Case 1 startTime DateSerial(Year(Now), Month(Now), Day(Now)) 16:00:00 endTime DateSerial(Year(Now), Month(Now), Day(Now)) 00:00:00 endTime DateAdd(d, 1, endTime) Case 2 startTime DateSerial(Year(Now), Month(Now), Day(Now)) 00:00:00 endTime DateSerial(Year(Now), Month(Now), Day(Now)) 08:00:00 End Select SmartTags(ReportStartTime) startTime SmartTags(ReportEndTime) endTime中班结束时间跨天这个点是最容易翻车的直接写0点意味着当前时刻的零点查询区间变成了负值数据永远查不出来。加一行DateAdd把日期推到明天这是吃过亏之后留下的固定写法。夜班查询要特别注意月初和月初数据核对因为跨月的时候归档表里上月末的数据只能从数据库侧查避免出现“今天1号夜班查不到上个月31号晚上”的乌龙。验证方法我习惯做三件事设定当前时间为班次切换前最后一分钟验证查询包含整个班次区间设定当前时间为切换后第一分钟验证不带上一个班的数据再跑一遍跨天班次的查询确认结束时间正确后移。从那以后我每次做完报表功能都强制走一遍这组边界验证报表导出前也会先拿同一台机器上另一份手动汇总的数据比对平均值确认后才上线发布。这些流程不复杂但能拦住绝大多数“客户刚看一眼报表就质疑数据真实性”的尴尬场面希望帮到你。本文还有配套的精品资源点击获取