WinCC用户归档实战：从配方批次追溯到SQL直连的完整案例

简介这份资源是面向工业自动化工程师与WinCC学习者的用户归档实践案例包聚焦西门子SCADA系统中动作与标准模块的协同机制帮助解决实时数据存储、历史数据检索与归档策略设计等实际问题。压缩包共290个文件约36.21MB以rpl归档数据文件为主辅以mdf、ldf数据库文件、dum转储文件、sav与ini配置、pdl画面、xml与cfg配置及多种脚本模块文件覆盖从归档数据到项目配置的完整结构。已有1150人学习下载适合需要动手搭建归档系统的初、中级技术人员参考。资源内含示例项目文件、脚本代码与步骤指南读者可据此理解动作触发归档、标准模块完成数据过滤与压缩的实现方式并学习归档间隔、保留期限与存储介质的选择思路提升WinCC项目中的数据管理效率与故障排查能力。1. 从一次配方批次追溯翻车说起wincc 用户归档案例到底解决什么问题去年帮一家做精细化工的客户排查问题他们的操作工在 HMI 上改了反应釜的保温时长第二天质检发现整批料不合格但谁也说不清当时到底是谁、在几点、把哪个参数从多少改成了多少。趋势曲线只记录了过程值操作动作和配方参数根本没进历史库。这就是典型的「数据在跑但没留痕」。wincc 用户归档案例要解决的正是这类场景把配方、批次、操作记录、质检结果这些结构化数据按自定义字段存进 SQL Server再在画面里做查询、导出和报表。它和 wincc 自带的历史趋势曲线是两套东西——趋势曲线存的是过程值用户归档存的是你定义字段的业务数据。适合谁看做流程行业上位机、需要做批次追溯和电子批记录的工程师尤其是被 GMP 或客户审核逼着要「谁在什么时候改了什么」的那批人。下面按我实际落地的顺序从建归档、写脚本、做查询一路讲到踩过的坑。2. 用户归档的底层逻辑与建库前的三个选型决定2.1 用户归档和趋势曲线、报警记录的本质区别很多人第一次接触 wincc 用户归档会以为它是趋势曲线的升级版其实两者底层存储和访问方式完全不同。趋势曲线走的是 WinCC 的归档系统数据点按时间戳压缩存储查询靠控件用户归档走的是独立的 SQL Server 数据库每条记录是你自己定义的字段组合本质是一张可读写的业务表。这意味着用户归档能做趋势曲线做不了的事存字符串、存批次号、存操作员姓名、存配方版本还能在运行时用脚本往里面插记录、改记录、删记录。从架构上看WinCC 用户归档由三部分组成归档组态定义字段和类型、运行时数据库SQL Server 里的实际表、以及访问接口WinCC 脚本或控件。归档组态在 WinCC 项目管理器里完成运行时数据库由 WinCC 自动在 SQL Server 里创建访问接口则是你写脚本的地方。理解这三层后面排查问题就不会乱——数据没进去先看组态字段对不对再看脚本有没有执行最后看数据库连接通不通。还有一个容易混淆的点用户归档的「归档」二字容易让人以为只能追加不能修改。实际上用户归档支持运行时写入、更新和删除这恰恰是它适合做配方管理和批次记录的原因。趋势曲线的数据你基本不会去改但配方参数、批次状态这些是需要随流程更新的。2.2 字段设计哪些该进用户归档哪些不该字段设计是用户归档案例里最容易埋雷的地方。我见过有人把整个配方几十个参数全塞进一张归档表结果查询慢、维护难、导出报表列多得没法看。我的经验是按业务对象拆表而不是按画面拆表。具体来说配方管理建一张表字段包括配方编号、配方名称、版本号、创建人、创建时间、审核状态批次记录建另一张表字段包括批次号、配方编号、开始时间、结束时间、操作员、设备号、质检结果。两张表通过配方编号关联。这样查询「某批次用了哪个版本的配方」就是一句关联查询的事。字段类型选择上WinCC 用户归档支持有限的数据类型数值、字符串、日期时间、布尔。注意字符串字段要设长度默认长度可能不够存中文名称。日期时间字段建议统一用 WinCC 的日期时间格式不要用字符串存时间否则后面做时间范围查询会非常痛苦。提示字段名不要用中文也不要用 SQL 保留字如 order、group、desc否则脚本访问时会出现莫名其妙的语法错误。2.3 建归档组态的最小步骤在 WinCC 项目管理器里用户归档位于「用户归档」编辑器下。右键新建归档命名建议用英文加下划线比如 recipe_master、batch_record。新建后先定义字段字段顺序会影响脚本里按索引访问的结果所以建议把关键字段放在前面。建完字段后需要设置归档的属性最大记录数、是否循环覆盖、是否允许运行时修改。最大记录数根据你的数据量和 SQL Server 空间来定批次记录这种只增不改的建议设大一点并关闭循环覆盖避免历史数据被冲掉。配方表这种记录数少的可以设小一点。组态完成后WinCC 会在 SQL Server 里生成对应的表。你可以在 SQL Server Management Studio 里看到这些表表名通常带前缀。确认表生成成功是后面脚本能跑通的前提。3. 用 C 脚本和 VBS 把数据写进用户归档3.1 两种脚本接口的选择与最小写入示例WinCC 提供两套脚本访问用户归档C 脚本ANSI-C和 VBS。C 脚本性能好、执行稳定适合高频写入VBS 语法友好、调试方便适合逻辑复杂的场景。我一般这样分配方保存、批次开始结束这种关键动作用 C 脚本查询、导出、界面交互用 VBS。先看 C 脚本写入的最小例子。假设已经建好归档 recipe_master字段依次是 recipe_id、recipe_name、version、create_time。// C脚本向用户归档 recipe_master 插入一条配方记录 // 触发点画面按钮的鼠标点击事件 #include apdefap.h void OnClick(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName) { // 打开用户归档返回归档句柄 long hArchive UA_OpenArchive(recipe_master); if (hArchive 0) { // 打开失败写诊断消息 printf(open archive failed\r\n); return; } // 创建一条新记录 long hRecord UA_CreateRecord(hArchive); if (hRecord 0) { UA_CloseArchive(hArchive); return; } // 按字段索引写值索引从0开始 UA_SetFieldValue(hRecord, 0, RCP-001); // recipe_id UA_SetFieldValue(hRecord, 1, 反应釜A标准配方); // recipe_name UA_SetFieldValue(hRecord, 2, 1); // version UA_SetFieldValue(hRecord, 3, GetLocalTime()); // create_time // 提交记录真正写入数据库 UA_WriteRecord(hRecord); // 释放句柄 UA_CloseRecord(hRecord); UA_CloseArchive(hArchive); }这段代码的逻辑是打开归档、创建记录、按索引填字段、提交、释放。关键参数说明UA_OpenArchive 的参数是归档名必须和组态里完全一致UA_SetFieldValue 的第二个参数是字段索引从 0 开始顺序就是组态里字段的顺序UA_WriteRecord 才是真正落库的动作前面只是构造记录。如果只调 UA_SetFieldValue 不调 UA_WriteRecord数据不会进数据库这是新手最常见的翻车点。3.2 VBS 查询与更新按批次号取记录查询场景用 VBS 更顺手。下面这个例子是按批次号查询记录并把结果写到画面上的 MSFlexGrid 或列表控件里。 VBS脚本按批次号查询用户归档 batch_record 触发点查询按钮的鼠标点击事件 Dim hArchive, hRecord, hQuery Dim batchNo, result batchNo HMIRuntime.Tags(QueryBatchNo).Read 从画面输入框读批次号 hArchive HMIRuntime.UserArchive.Open(batch_record) If hArchive 0 Then HMIRuntime.Trace open archive failed vbCrLf Exit Sub End If 构造查询条件字段索引0是批次号 hQuery HMIRuntime.UserArchive.Query(hArchive, 0, batchNo) If hQuery 0 Then HMIRuntime.Trace no record found vbCrLf HMIRuntime.UserArchive.Close hArchive Exit Sub End If 遍历查询结果 Do While HMIRuntime.UserArchive.MoveNext(hQuery) 0 result HMIRuntime.UserArchive.GetFieldValue(hQuery, 0) | _ HMIRuntime.UserArchive.GetFieldValue(hQuery, 1) | _ HMIRuntime.UserArchive.GetFieldValue(hQuery, 2) HMIRuntime.Trace result vbCrLf Loop HMIRuntime.UserArchive.CloseQuery hQuery HMIRuntime.UserArchive.Close hArchive逻辑说明先打开归档用 Query 方法按字段索引和值构造查询返回查询句柄然后 MoveNext 遍历结果集GetFieldValue 按索引取值。参数上Query 的第二个参数是字段索引第三个是匹配值只支持等值匹配不支持模糊查询。如果需要模糊查询或范围查询得用 SQL 直接访问数据库或者把数据取出来在脚本里过滤。更新记录用 UA_UpdateRecord 或 VBS 对应的 Update 方法思路是先查询定位到记录改字段值再提交。注意更新前要确保记录句柄有效否则会静默失败。3.3 脚本触发时机与性能注意点脚本触发时机直接决定数据完整性。配方保存按钮用鼠标点击触发没问题但批次开始结束这种跟设备状态绑定的建议用变量触发或全局脚本周期执行避免操作工忘记点按钮导致记录缺失。性能上C 脚本单次写入通常在毫秒级但如果你在循环里连续写几百条建议批量构造后一次性提交或者用事务。VBS 查询大量记录时MoveNext 遍历会明显变慢超过一千条建议直接走 SQL 查询。另外脚本里打开归档后一定要关闭否则句柄泄漏会导致后续操作失败这个坑我在现场踩过表现是运行几小时后所有归档操作都无响应。4. 把用户归档接到画面查询、报表导出和批次追溯4.1 用 WinCC 控件做查询界面的最小配置WinCC 自带用户归档控件User Archive Control可以直接拖到画面上做查询和显示不用写太多脚本。配置步骤在画面里插入控件设置归档名配置要显示的列对应字段然后绑定查询条件变量。控件支持运行时输入查询值、翻页、导出 CSV。但自带控件样式比较固定客户往往要求自定义界面。我的做法是用 MSFlexGrid 或 ListView 控件配合 VBS 脚本自己控制显示逻辑。这样界面自由度大但需要自己处理分页和排序。分页思路是查询时只取当前页需要的记录用 SQL 的 TOP 和 OFFSET或者把结果集缓存在脚本变量里。注意用户归档控件在 Web 发布或 WinCC 冗余环境下行为可能不一致如果项目涉及这些场景建议提前验证。4.2 导出 Excel 报表的脚本实现报表导出是用户归档案例里客户最常提的需求。下面用 VBS 调用 Excel COM 对象把查询结果写进 Excel 并保存。 VBS脚本把用户归档查询结果导出到Excel Dim hArchive, hQuery, xlApp, xlBook, xlSheet, rowIdx hArchive HMIRuntime.UserArchive.Open(batch_record) hQuery HMIRuntime.UserArchive.Query(hArchive, 0, HMIRuntime.Tags(QueryBatchNo).Read) Set xlApp CreateObject(Excel.Application) Set xlBook xlApp.Workbooks.Add Set xlSheet xlBook.Worksheets(1) 写表头 xlSheet.Cells(1,1) 批次号 xlSheet.Cells(1,2) 配方编号 xlSheet.Cells(1,3) 操作员 xlSheet.Cells(1,4) 开始时间 rowIdx 2 Do While HMIRuntime.UserArchive.MoveNext(hQuery) 0 xlSheet.Cells(rowIdx,1) HMIRuntime.UserArchive.GetFieldValue(hQuery, 0) xlSheet.Cells(rowIdx,2) HMIRuntime.UserArchive.GetFieldValue(hQuery, 1) xlSheet.Cells(rowIdx,3) HMIRuntime.UserArchive.GetFieldValue(hQuery, 2) xlSheet.Cells(rowIdx,4) HMIRuntime.UserArchive.GetFieldValue(hQuery, 3) rowIdx rowIdx 1 Loop xlBook.SaveAs D:\Reports\batch_ HMIRuntime.Tags(QueryBatchNo).Read .xlsx xlBook.Close xlApp.Quit Set xlSheet Nothing Set xlBook Nothing Set xlApp Nothing逻辑说明创建 Excel 应用对象新建工作簿逐行写入查询结果最后按批次号命名保存。参数上SaveAs 的路径要确保 WinCC 运行账户有写权限否则会报权限错误。另外 Excel COM 调用比较慢记录多时建议改用 CSV 直接写文件速度快且不依赖 Office 安装。4.3 批次追溯的完整数据链路批次追溯的完整链路是批次开始时写入批次记录批次号、配方编号、开始时间、操作员过程中把关键工艺参数写入用户归档或趋势归档批次结束时更新批次记录的结束时间和质检结果。查询时通过批次号关联配方表和批次表还原出「谁、在什么时间、用什么配方、做了什么、结果如何」。这条链路里最容易断的是过程中参数记录。如果工艺参数只进了趋势归档追溯时要把趋势数据和批次时间范围做关联查询比较麻烦。我的建议是关键工艺参数同时写一份到用户归档字段包括批次号、参数名、参数值、时间戳这样追溯时一张表就能查全。5. 用户归档避坑与排查五条血泪经验5.1 现象脚本执行了但数据库里没数据原因最常见的是只调了 UA_SetFieldValue 没调 UA_WriteRecord记录只在内存里构造没提交。其次是归档名拼写和组态不一致UA_OpenArchive 返回失败但脚本没做错误处理静默跳过。还有一种情况是字段索引越界比如组态只有 4 个字段脚本写了索引 5写入被拒绝。解决在脚本里对每一步的返回值做判断失败时写诊断消息到文件或报警。归档名建议从组态里复制不要手敲。字段索引和组态顺序核对一遍建议在脚本开头用注释标明索引对应关系。5.2 现象查询返回空结果但数据库里明明有数据原因查询条件字段索引写错了或者查询值类型不匹配。比如批次号字段是字符串查询时传了数值等值匹配就失败。还有一种情况是查询值带了空格或不可见字符从画面输入框读出来没做 Trim。解决先确认字段索引再确认类型。字符串查询值统一做 Trim 处理。如果还是查不到直接在 SQL Server 里用 SELECT 语句查同一条件确认数据确实存在且值一致。5.3 现象运行几小时后归档操作全部失败原因句柄泄漏。脚本里打开归档和查询后没有关闭句柄耗尽后后续操作全部失败。这个问题的隐蔽性在于前期一切正常运行时间长了才暴露。解决所有 Open 操作必须有对应的 Close建议用 On Error Resume Next 配合错误处理确保异常时也能释放。C 脚本里 UA_CloseArchive 和 UA_CloseRecord 都要调VBS 里 CloseQuery 和 Close 都不能漏。5.4 现象中文配方名写入后显示乱码原因WinCC 用户归档的字符串字段编码和脚本传入的编码不一致或者字段长度不够导致截断。C 脚本里字符串默认是 ANSI 编码如果组态字段是 Unicode需要转换。解决字段长度设够中文名称建议至少 64 字符。C 脚本里用 MultiByteToWideChar 转换编码或者直接用 VBS 写入VBS 字符串默认 Unicode兼容性更好。5.5 现象导出 Excel 时报权限错误或文件被占用原因WinCC 运行账户对目标路径没有写权限或者上一次导出的 Excel 进程没退出文件被锁。Excel COM 调用后如果没正确 Quit进程会残留在后台。解决导出路径选 WinCC 运行账户有写权限的目录比如项目目录下的 Reports 文件夹。每次导出前检查是否有残留的 Excel 进程脚本里确保 Quit 和释放对象。如果还是不稳定改用 CSV 导出不依赖 Office。6. 进阶用 SQL 直连做复杂查询和归档表结构优化用户归档自带的查询接口只支持等值匹配做范围查询、模糊查询、多表关联时很受限。我的做法是复杂查询直接走 SQL Server。WinCC 用户归档的表在 SQL Server 里是普通表表名通常是 UA 加归档名字段名对应组态里的字段名。你可以用 ADO 或 SQL 脚本直接查。-- 查询某时间段内所有不合格批次的配方使用情况 SELECT b.batch_no, b.operator, r.recipe_name, r.version, b.qc_result FROM UA_batch_record b LEFT JOIN UA_recipe_master r ON b.recipe_id r.recipe_id WHERE b.start_time BETWEEN 2024-01-01 AND 2024-01-31 AND b.qc_result NG ORDER BY b.start_time DESC;这条 SQL 做了两件事按时间范围过滤批次关联配方表取配方名称和版本。参数上时间范围用字符串格式传入SQL Server 会自动转换关联字段 recipe_id 在两张表里类型要一致否则关联会隐式转换导致性能下降。表结构优化上建议给常用查询字段建索引比如批次号、开始时间、配方编号。索引能显著提升查询速度但会稍微拖慢写入批次记录这种写入频率不高的场景建索引是划算的。另外用户归档表的数据量大了之后建议定期归档旧数据到历史表保持主表轻量。我自己的习惯是项目交付前一定用 SQL 直连做一次全量数据核对确认用户归档里的记录数和业务预期一致字段值没有截断或乱码。这个动作帮我提前发现过好几次字段长度不够的问题。希望帮到你。本文还有配套的精品资源点击获取