最后确认并导出结果

至少确认符号地址、绝对地址、数据类型、报警/趋势标记、地址状态、备注和规则处理结果都正确。勾选通常用于复核和批量操作,最终导出以当前结果列表中保留下来的规范化点位为准。

Step 6

Step 6: 最后确认并导出结果

确认导出范围和字段边界后再导出,避免误以为所有扫描过程信息都会进入结果文件。

导出前确认什么

至少确认符号地址、绝对地址、数据类型、报警/趋势标记、地址状态、备注和规则处理结果都正确。勾选通常用于复核和批量操作,最终导出以当前结果列表中保留下来的规范化点位为准。

支持的导出内容

现代界面中的“导出当前结果”按钮支持保存为单个 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。

CLI 配置字段写法

配置文件的主要字段包括 projectPathoutputDirincludePlcNamesdeviceCodeOverridesonlinedefaultsfiltersnamingclassificationprojectPath 指向 TIA 项目或归档文件,outputDir 指向结果目录;includePlcNames 限定 PLC;deviceCodeOverrides 把 PLC 名映射为目标系统设备编码;filters 控制地址区、DB 范围、名称和项目树范围;classification 控制报警和趋势分类。

CLI 配置示例

下面示例展示常见字段。实际项目应替换项目路径、输出目录、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 }]
  }
}

在线 CLI 配置示例

如果没有 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,会按输出目录写入导入文件、通用文件和报告文件。固定流程中建议先用 preview 确认范围,再运行正式输出。

不会导出什么

界面“导出当前结果”不会导出原始 TIA 项目文件、完整项目树、规则配置本身、界面筛选/展开状态、当前勾选状态、内部运行日志,也不会自动生成 WinCC、Ignition 或 HQControl 兼容包。没有被规范化成点位行的结构化内容、已经从当前结果中删除、被规则排除、超出扫描范围或读取失败的对象,也不会出现在最终文件里。

为什么有些内容没被导出

通常是因为对象不在本次扫描范围内、被规则中心过滤或排除、人工从结果中移除、地址或类型无法解析,或者该对象本身不是可导出的标签行。导出文件只承载可复核和可交付的点位字段,不等同于项目的完整备份。

DB 没导出时先看哪几项

先确认该 DB 是否在项目树选中范围内,是否能被 Openness 读取,是否被规则中心排除,是否为优化 DB 且只能走符号地址,是否包含复杂结构或不支持的数据类型,以及 PLC 侧是否允许 HMI、OPC UA 或外部访问。确认后再决定是显式单独扫描,还是在 PLC 工程里拆分成可导出的标量点。

导出格式选择方式

人工复核优先 Excel,程序处理优先 CSV 或 JSON;后续要导入系统时,先按目标系统字段结构检查一遍,确认缺失项是否属于上述不导出范围。