确认 Windows x64、.NET Framework 4.8、TIA Portal 和 Automation License Manager Service 正常。
文档手册
Mingcedar Scan 现场排障
依次检查 TIA 环境、Openness 权限、扫描范围、规则和导出字段。
开始扫描前先确认环境
Mingcedar Scan 从离线 TIA 工程整理标准 DB 点位；扫描前须确认环境和权限。
用本机 TIA Portal 打开目标工程，确认当前用户具备 Openness 权限。
从一个 PLC 或标准 DB 开始，核对地址和数量后再扩大范围。
TIA Portal、项目或 Openness 权限异常
环境不正常时，扫描结果可能为空、缺字段或直接失败。
确认扫描程序构建与本机 TIA/Openness API 兼容。项目版本须为 V14 或更高，且不能高于选定的 TIA；较早版本会尝试升级，能否成功取决于 TIA API。V21 需要专用构建。
确认 Windows x64 已启用 .NET Framework 4.8，Automation License Manager Service 正在运行。
确认当前用户在 Siemens TIA Openness 用户组中；修复权限会请求管理员提权，完成后通常要注销并重新登录 Windows。
项目不要放在只读目录、临时目录或网络不稳定路径。路径过长或包含异常字符时，先复制到本地短路径。
修复权限后仍然读取失败
Openness 权限通常需要重新登录 Windows 或重启 TIA/Mingcedar Scan 才会完全生效。
把当前用户加入 Siemens Openness 相关用户组后，注销并重新登录 Windows，再打开 TIA Portal 和 Mingcedar Scan。
项目来自压缩包、共享目录或只读目录时，先复制到本机可写路径再扫描。
项目版本不得高于所选 TIA，扫描程序须支持该 TIA。升级失败时，在 TIA Portal 中打开并升级工程，再扫描。
扫描为空、很慢或结果数量异常
先缩小扫描范围，再看项目树、PLC 和 DB 选择是否正确。
先确认目标 DB 为标准布局，再检查项目树是否选中了实际 PLC/DB，以及是否启用了过严的 HMI/OPC 访问范围或规则。
先确认标准布局；优化或布局未知 DB 会整块跳过。再检查项目树/PLC/DB 范围、Openness 读取、访问属性和规则。结果中标为 absolute_unverified 的成员可供复核，但不会进入通信导入文件。
按 PLC、DB 编号或项目树缩小范围；含大型数组、UDT 或多层结构的 DB 可单独扫描。
先用保留规则圈定主集合，再用排除规则处理诊断、临时和中间变量。
大型项目扫描或导出很慢
先按 PLC 或 DB 小范围扫描并验证规则，确认结果后再扩大扫描范围。
按 PLC 或 DB 分批扫描，核对布局、地址和规则后再扩大范围。
先用业务 DB 验证范围、字段和规则，再单独复核备份、历史、装载内存 DB 及复杂数组或 UDT。
先用保留规则缩小主集合，再用排除规则清理诊断、临时、中间变量，减少后续人工复核量。
导出前抽样检查符号地址、绝对地址和数据类型。字段异常时先调整范围或规则，再进行系统导入。
符号地址、绝对地址或数据类型不符合预期
导入前核对符号地址、绝对地址和数据类型。
符号路径用于识别工程成员，但 Rule Center 名称规则只匹配显示名和规范编码，并不会自动匹配整条符号路径或注释。
标准布局 DB 的结果可包含 absolute_unverified 成员。此类地址仅供复核；只有具备受信地址证据并通过类型等检查的成员，才会进入通信导入文件。优化或未知布局 DB 会整块跳过。
界面导出中 `ioOffset` 是字节偏移，`bitOffset` 是独立位偏移；只有 BOOL 填位，位 0 显示为 `0`，其他类型该列为空。
通信导入支持 BOOL、BYTE、USINT、SINT、WORD、UINT、DWORD、UDINT、INT、DINT、REAL、TIME；FLOAT 按 REAL 处理。CHAR、WCHAR、字符串、64 位及其他日期时间类型仅供复核，不用于通信导入。
符号地址、编码重复或字段规范不符合导入要求
导入前核对符号地址、编码唯一性和字段规范。
符号地址和导入编码应避免控制字符、不可见字符、异常标点或路径符号。发现此类内容时，先在规则或工程侧整理。
同一设备下 Tag 编码必须唯一。重复时先按规则生成稳定编码，再人工确认。
UDT、数组和结构体应按可复核的标量成员整理。需要独立采集的值，建议在 PLC 工程中整理为明确标量。
导出文件无法导入或字段对应不上
先区分界面中性导出与 CLI 的 Mingcedar 兼容输出，再按目标系统官方规范做字段映射。
界面“导出当前结果”只保存一个 .xlsx、.csv 或 .json；Mingcedar 的 tag/alarm/trend 兼容 JSON 只由 CLI 非 preview 扫描生成。
界面导出用于复核，可包含未验证地址或不支持通信导入的类型。CLI 通信导入文件仅包含通过地址证据和类型检查的成员；不要直接把复核结果当作可采集点位。
界面导出没有 `deviceCode` 列。先核对 plcName、symbolicAddress、absoluteAddress、dbNo、ioOffset、bitOffset、dataType 等实际列，再决定怎样转换。
Excel、CSV、JSON 是中性结果，不是任意 SCADA/HMI 的官方模板。字段、地址模式和类型必须按目标系统文档自行映射并实测。
优化/未知布局、范围未选、读取失败或被规则排除的 DB/成员不会出现在结果中。恢复的历史会话可导出复核文件，但地址证据会降级；生成通信导入文件前须重新扫描。