支持导出的类型、类别和规范

现代界面的“导出当前结果”支持 Excel 工作簿 .xlsx、CSV UTF-8 .csv、JSON UTF-8 .json。Excel 适合人工复核,CSV 适合批量处理和表格工具,JSON 适合程序二次转换。命令行非 preview 模式还会生成 reviewed-tags、normalized-tags、report 和 export-manifest 等兼容输出。

规范

规范: 支持导出的类型、类别和规范

导出结果只包含已经规范化成点位行的数据。先确认来源、符号地址、数据类型和匹配规则,再决定是否导入 HQControl 或交给后续流程。

支持的导出文件类型

现代界面的“导出当前结果”支持 Excel 工作簿 .xlsx、CSV UTF-8 .csv、JSON UTF-8 .json。Excel 适合人工复核,CSV 适合批量处理和表格工具,JSON 适合程序二次转换。命令行非 preview 模式还会生成 reviewed-tags、normalized-tags、report 和 export-manifest 等兼容输出。

支持的点位来源类别

可导出的点位来自全局 DB、实例 DB 中可以解析成标量点位的成员。项目树未选中的 DB、被规则过滤的对象、读取失败的对象、复杂结构本身和非点位工程对象,不属于最终导出清单。

在线扫描来源类别

在线扫描的点位来源是 PLC OPC UA Server 当前可浏览的变量节点。它不读取本机 TIA 项目树,也不使用 S7 102 端口推断优化 DB 结构。在线导出适合 PLC 已明确开放 OPC UA 变量的场景。

地址范围

扫描和导出主范围以 DB 点位为主。DB 点位优先保留符号地址;离线扫描在 TIA 元数据稳定时补充 DB 号、字节偏移、位偏移和访问类型。

支持的绝对地址格式

DB 绝对地址支持 DBn.DBXbyte.bit、DBn.DBBbyte、DBn.DBWbyte、DBn.DBDbyte。优化 DB、在线 OPC UA 节点或结构数组成员如未提供稳定偏移,结果以符号地址为准。

支持的数据类型

可导出数据类型以标量为主:BOOL;BYTE、SINT、USINT、CHAR;WORD、UINT;DWORD、UDINT;LWORD、ULINT;INT、DINT、LINT;REAL、FLOAT、LREAL;TIME、DATE、TIME_OF_DAY/TOD、DATE_AND_TIME/DT、LTIME、LDATE、LTIME_OF_DAY/LTOD、LDT、DTL;STRING、STRING[n]、WSTRING、WSTRING[n]。最终导出会归一到 BOOL、BYTE、WORD、DWORD、LWORD、INT、DINT、LINT、REAL、LREAL、STRING、WSTRING 或对应时间日期类型。

结构化对象处理

UDT、Struct、Array、嵌套对象、FB/FC、DB 容器和复杂对象引用主要用于描述工程结构。能够展开为支持标量的子成员时,导出对应子成员;需要独立采集的结构化内容,建议在 PLC 工程中整理为明确标量。

导出字段规范

复核导出行包含 PLC 名称、符号地址/来源路径、绝对地址、DB 号、偏移、位偏移、数据类型、扫描周期、报警标记、趋势标记、地址状态和备注。JSON 还包含导出时间、项目路径、输出目录、点位数量、报警数量、趋势数量和 rows 明细。

命名和导入规范

同一设备下符号地址应唯一;deviceCode 要与目标系统设备编码完全一致。符号地址用于 OPC UA/S7 符号模式,绝对地址用于 S7 102 或类似绝对地址链路,导入前要先确认目标系统使用哪一种地址模式。

报警和趋势类别

报警、趋势不是新的 PLC 数据类型,而是点位上的分类标记。Rule Center 可以按符号地址、注释、来源路径和数据类型给点位打报警或趋势标记;导出时分别用 alarm 和 trend 字段表示是否启用,便于后续人工复核或系统导入。

导出文件用途表

reviewed-tags.csv 和 reviewed-tags.json 用于保存复核后的平铺点位表;normalized-tags.json 保留规范化后的完整字段;tag-import.json 用于 Tag 导入准备;alarm-import.json 和 trend-import.json 分别承载报警、趋势候选;hqserver-create-tags.json 是创建 Tag 的兼容数据;generic-tags.csv/json 适合通用二次处理;ignition-starter.csv 和 wincc-starter.csv 是外部平台映射起点;report.json 保存数量、耗时、类型分布和过滤原因;export-manifest.json 说明本次输出目录中的文件用途。

字段与目标系统对应关系

deviceCode 必须与目标系统设备编码一致;areaCodeobjectIdentifiergroupCode 用于组织点位归属;addresssymbolicPath 用于符号访问;dbNobyteOffsetbitOffsetoffsetTextabsoluteAddress 用于绝对地址访问;hqDataTypetagTypevalueType 决定数据类型映射;scanRateMsalarmEnabledarchiveEnabled 决定默认采集周期、报警和趋势分类。

符号地址和绝对地址选择方式

PLC 和目标系统都支持符号访问时,优先使用符号地址,便于跟随工程命名维护。需要走 S7 102 绝对地址链路时,再使用 DB 号、字节偏移和位偏移。在线 OPC UA 结果通常以符号节点为主;离线 TIA 项目在能解析稳定偏移时才补充绝对地址。