文档手册

最后确认并导出结果

核对地址、验证状态、类型、分类、注释和规则。导出包含全部保留点位，勾选、搜索和“只看已勾选”不限制导出行数；需减少行数时，应用规则或删除无关行。

步骤 6

步骤 6: 最后确认并导出结果

核对导出范围、字段和结果工程后保存文件。

导出前确认什么

导出前确认结果工程

导出前会比较工程路径；不一致时停止导出并清空旧结果。包含已验证地址时，还会检查工程内容、扫描配置和 TIA 运行环境是否与扫描时一致；发生变化会拒绝导出，应重新扫描。恢复的会话可导出未验证的复核清单。

支持的导出内容

点击“导出当前结果”，选择 Excel、CSV 或 JSON 及保存位置，导出复核后保留的点位。

界面导出与命令行输出

桌面界面只保存所选的单个 .xlsx、.csv 或 .json 文件。需要 Mingcedar 兼容文件及批量报告时，使用非 preview 模式的命令行扫描；输出文件及用途见“导出规范”。

命令行批量扫描

重复扫描可用 CLI 和配置文件生成归档目录；preview 仅快速预览，不生成完整导入文件。

HQScan.Openness.Cli.exe scan --config scan-config.json
HQScan.Openness.Cli.exe scan --config scan-config.json --project "<project-file>" --out "<output-dir>" --preview

CLI 配置字段写法

配置文件的主要字段包括 projectPath、outputDir、includePlcNames、deviceCodeOverrides、defaults、filters、naming 和 classification。当前扫描器会把地址区约束为 DB；其余字段用于限定 PLC、DB/项目树范围、名称规则、命名派生及报警/趋势分类。

CLI 配置示例

使用前请将示例中的工程路径、输出目录、PLC 名称、设备编码和规则文本替换为实际值，并按目标系统要求验证导入字段。

{
  "projectPath": "<project-file>",
  "outputDir": "<output-dir>",
  "includePlcNames": ["<PLC name>"],
  "deviceCodeOverrides": { "<PLC name>": "<device code>" },
  "defaults": { "scanRateMs": 1000, "sourceKind": "plc" },
  "filters": {
    "includeAddressAreas": ["DB"],
    "includeDBs": ["DB1-DB50"],
    "excludeNames": ["%EXCLUDE_TOKEN%"]
  },
  "classification": {
    "alarmRules": [{ "namePatterns": ["%ALARM_TOKEN%"], "setAlarmEnabled": true }],
    "trendRules": [{ "namePatterns": ["%TREND_TOKEN%"], "setArchiveEnabled": true }]
  }
}

preview 和正式输出的区别

--preview 快速扫描使用默认分类，不应用完整的逐点名称过滤和报警、趋势规则，数量及标记不能用于验收正式输出。指定目录时仅写 preview-report.json，不生成通讯导入文件。不带 --preview 时应用规则并输出数据与报告；导入行数还受地址证据和类型限制。

不会导出什么

“导出当前结果”不包含原始 TIA 项目、完整项目树、规则配置、界面状态或运行日志，也不生成其他平台或 Mingcedar 专用导入包。超出扫描范围、读取失败、被规则排除或从结果中删除的对象不会出现在导出文件中。

为什么有些内容没被导出

检查对象是否超出范围、被规则或人工移除、地址或类型无法解析，或并非点位。导出仅包含点位字段，不是工程备份。

DB 没导出时先看哪几项

先确认该 DB 是否为标准布局，再检查项目树、PLC 与 DB 范围、Openness 读取、HMI/OPC 访问选项、规则、数据类型和绝对地址。若确需调整 TIA 工程布局，应先评估地址变更对现有系统的影响，再重新扫描和验证。

导出格式选择方式

人工复核用 Excel，程序处理用 CSV 或 JSON。导入前按目标系统核对字段，并检查缺失项是否属于不导出范围。