导出前确认什么
至少确认符号地址、绝对地址、数据类型、报警/趋势标记、地址状态、备注和规则处理结果都正确。勾选通常用于复核和批量操作,最终导出以当前结果列表中保留下来的规范化点位为准。
至少确认符号地址、绝对地址、数据类型、报警/趋势标记、地址状态、备注和规则处理结果都正确。勾选通常用于复核和批量操作,最终导出以当前结果列表中保留下来的规范化点位为准。
至少确认符号地址、绝对地址、数据类型、报警/趋势标记、地址状态、备注和规则处理结果都正确。勾选通常用于复核和批量操作,最终导出以当前结果列表中保留下来的规范化点位为准。
现代界面中的“导出当前结果”按钮支持保存为单个 Excel、CSV 或 JSON 文件。导出的行来自当前复核后的规范化点位结果,具体来源类别、数据类型和字段规范见“导出规范”小节。
现代界面扫描先生成可复核的当前结果列表,不会在扫描时立刻写出全套兼容文件;点击“导出当前结果”时,只会写入保存对话框中选择的那个 .xlsx、.csv 或 .json 文件。命令行非 preview 扫描才会按输出目录写出 normalized-tags.json、tag-import.json、alarm-import.json、trend-import.json、hqserver-create-tags.json、generic-tags.csv/json、ignition-starter.csv、wincc-starter.csv 和 export-manifest.json。
需要在固定工程机或自动化流程中重复扫描时,使用命令行入口并传入配置文件。命令行适合生成可归档的输出目录,preview 模式只执行快速预览路径,不写出完整导入文件。
HQScan.Openness.Cli.exe scan --config scan-config.json
HQScan.Openness.Cli.exe scan --config scan-config.json --project D:\\Projects\\LineA.ap19 --out D:\\HQScan\\LineA --preview
非 preview 扫描会按配置写出规范化点位、HQControl 导入文件和报告文件。常用文件包括 normalized-tags.json、tag-import.json、alarm-import.json、trend-import.json、hqserver-create-tags.json 和 report.json。
配置文件的主要字段包括 projectPath、outputDir、includePlcNames、deviceCodeOverrides、online、defaults、filters、naming 和 classification。projectPath 指向 TIA 项目或归档文件,outputDir 指向结果目录;includePlcNames 限定 PLC;deviceCodeOverrides 把 PLC 名映射为目标系统设备编码;filters 控制地址区、DB 范围、名称和项目树范围;classification 控制报警和趋势分类。
下面示例展示常见字段。实际项目应替换项目路径、输出目录、PLC 名称、设备编码和规则文本。
{
"projectPath": "D:\\Projects\\LineA.ap19",
"outputDir": "D:\\HQScan\\LineA",
"includePlcNames": ["PLC_1"],
"deviceCodeOverrides": { "PLC_1": "LINE_A_PLC" },
"defaults": { "scanRateMs": 1000, "sourceKind": "plc" },
"filters": {
"includeAddressAreas": ["DB"],
"includeDBs": ["DB1-DB50"],
"excludeNames": ["%BACKUP%", "%HISTORY%"]
},
"classification": {
"alarmRules": [{ "namePatterns": ["%ALM%"], "setAlarmEnabled": true }],
"trendRules": [{ "namePatterns": ["%PV%", "%SP%"], "setArchiveEnabled": true }]
}
}
如果没有 TIA 项目,只需要整理 PLC 已开放的 OPC UA 节点,可以在配置里使用 online.endpoint。在线配置只代表 OPC UA 浏览来源,不会读取本机 TIA 项目。
{
"outputDir": "D:\\HQScan\\Online-LineA",
"online": {
"endpoint": "opc.tcp://192.168.0.1:4840",
"timeoutMs": 3000,
"maxBrowseNodes": 500000,
"browseBatchSize": 32,
"attributeBatchSize": 64
},
"deviceCodeOverrides": { "192.168.0.1": "LINE_A_PLC" },
"filters": { "includeNames": ["%LineA%"] }
}
--preview 走快速预览路径,用于确认配置、范围和数量,不写出完整导入文件;正式输出不带 --preview,会按输出目录写入导入文件、通用文件和报告文件。固定流程中建议先用 preview 确认范围,再运行正式输出。
界面“导出当前结果”不会导出原始 TIA 项目文件、完整项目树、规则配置本身、界面筛选/展开状态、当前勾选状态、内部运行日志,也不会自动生成 WinCC、Ignition 或 HQControl 兼容包。没有被规范化成点位行的结构化内容、已经从当前结果中删除、被规则排除、超出扫描范围或读取失败的对象,也不会出现在最终文件里。
通常是因为对象不在本次扫描范围内、被规则中心过滤或排除、人工从结果中移除、地址或类型无法解析,或者该对象本身不是可导出的标签行。导出文件只承载可复核和可交付的点位字段,不等同于项目的完整备份。
先确认该 DB 是否在项目树选中范围内,是否能被 Openness 读取,是否被规则中心排除,是否为优化 DB 且只能走符号地址,是否包含复杂结构或不支持的数据类型,以及 PLC 侧是否允许 HMI、OPC UA 或外部访问。确认后再决定是显式单独扫描,还是在 PLC 工程里拆分成可导出的标量点。
人工复核优先 Excel,程序处理优先 CSV 或 JSON;后续要导入系统时,先按目标系统字段结构检查一遍,确认缺失项是否属于上述不导出范围。