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

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

规范

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

导出结果只包含已经规范化成点位行的数据。先确认来源、符号地址、数据类型和匹配规则,再决定交给其他 SCADA / HMI、自研系统,或按需生成 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、被规则过滤的对象、读取失败的对象、复杂结构本身和非点位工程对象,不属于最终导出清单。

地址范围

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

支持的绝对地址格式

DB 绝对地址支持位、字节、字和双字格式。例如:BOOL 点位可以表示为 DB12.DBX4.1,BYTE 点位可以表示为 DB12.DBB8,WORD 点位可以表示为 DB12.DBW10,DWORD 或 REAL 点位可以表示为 DB12.DBD12。优化 DB 或结构数组成员未提供稳定偏移时,结果以符号地址为准。

支持的数据类型

可导出数据类型以标量为主: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 适合通用二次处理;report.json 保存数量、耗时、类型分布和过滤原因;export-manifest.json 说明本次输出目录中的文件用途。

字段与目标系统对应关系

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

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

PLC 和目标系统都支持符号访问时,优先使用符号地址,便于按照工程命名维护。需要采用绝对地址访问时,再使用 DB 号、字节偏移和位偏移。HQ Scan 仅在 TIA 工程能够解析稳定偏移时补充绝对地址。