HMI报警记录的PDF报表生成

实现 HMI 报警记录自动生成 PDF 报表是工业现场数据追溯的关键环节。本指南将跳过理论叙述，直接提供从零配置到最终输出的可执行步骤。整个过程分为环境准备、组态设置、脚本编写、触发测试四个阶段。

第一阶段：环境与变量准备

在开始组态前，必须确认硬件存储路径与变量地址映射正确。大多数 HMI 支持 USB 存储或网络共享路径作为报表导出目的地。

1. 确认 存储介质格式。将 U 盘格式化为 FAT32 或 exFAT 文件系统，确保 HMI 系统可读写。

2. 创建 目标文件夹。在存储根目录下新建文件夹，命名为 Report，用于存放生成的 PDF 文件。

3. 定义 内部变量。在 HMI 变量表中建立以下三个关键变量，用于控制报表逻辑：

   变量名称	数据类型	地址/初始值	功能说明
   Btn_GenPDF	布尔型	False	手动触发生成按钮信号
   Sys_AlarmCount	整型	0	读取当前未确认报警数量
   File_Path	字符串	"USB:\Report\"	存储路径前缀

4. 检查 系统时间。确保 HMI 系统时钟与服务器同步，否则报表时间戳将出现错误，导致追溯失效。

第二阶段：报警记录组态配置

报警记录是 PDF 报表的数据源。需要确保报警事件被正确记录到本地日志文件中，通常格式为 .csv 或 .txt，后续脚本将其转换为 PDF。

1. 打开 报警记录设置界面。进入工程软件的项目树，找到 报警管理 或 Alarm Logging 选项。
2. 启用 存档功能。勾选 将报警消息存档 选项，设置存档周期为 每天 或 每条 1000 条，避免文件过大导致读取超时。
3. 设置 存档路径。输入 路径 USB:\AlarmLog\，确保与报表存储路径区分开，防止文件冲突。
4. 配置 列信息。选择 需要导出的字段，至少包含 时间、报警文本、状态、确认时间。不要勾选无关的系统内部代码，以减小文件体积。
5. 保存 项目设置。点击 编译按钮，确保无报错后下载至 HMI 设备。

报警数据流向逻辑如下，请确保实际配置符合此流程：

第三阶段：脚本编写与转换逻辑

HMI 通常不直接支持生成 PDF，需要通过脚本调用系统打印功能或转换中间文件。以下以常见的 VBScript 为例，展示如何将 CSV 日志转换为可打印格式。

1. 新建 全局脚本。在工程软件的 脚本 管理器中，创建一个新的全局函数，命名为 GenerateAlarmPDF。

2. 输入 文件读取代码。复制 以下代码片段至脚本编辑器，注意修改路径匹配实际硬件：

   Sub GenerateAlarmPDF
       Dim fso, srcFile, dstFile
       Set fso = CreateObject("Scripting.FileSystemObject")
   
       ' 定义源文件与目标文件路径
       srcFile = "USB:\AlarmLog\AlarmLog.csv"
       dstFile = "USB:\Report\Alarm_Report.pdf"
   
       ' 检查源文件是否存在
       If fso.FileExists(srcFile) Then
           ' 调用系统打印接口转换格式
           ' 注意：具体函数名取决于 HMI 品牌 API
           Call SystemPrint.Convert(srcFile, dstFile)
   
           ' 更新状态变量
           HMIVariables("Btn_GenPDF") = False
           HMIVariables("Sys_AlarmCount") = 0
       Else
           ' 文件不存在时触发提示
           HMIVariables("Sys_AlarmCount") = -1
       End If
   
       Set fso = Nothing
   End Sub

3. 绑定 触发事件。在 HMI 画面中放置一个按钮，文本设为 生成报表。

4. 设置 按钮动作。选择 鼠标释放 事件，关联脚本 GenerateAlarmPDF。

5. 配置 定时任务。若需自动生成，进入 任务计划 设置，添加 新任务，触发条件设为 每天 08:00，动作关联上述脚本。

第四阶段：现场测试与验证

下载项目后，必须进行现场模拟测试，确保报表内容完整且格式可读。

1. 触发 模拟报警。在 PLC 端强制置位一个报警变量，观察 HMI 是否弹出报警窗口并记录日志。
2. 执行 生成操作。点击 画面上的 生成报表 按钮，等待约 5-10 秒（取决于数据量）。
3. 检查 存储文件。拔出 U 盘连接电脑，打开 USB:\Report\ 文件夹，确认是否存在新生成的 .pdf 文件。
4. 验证 内容精度。打开 PDF 文件，核对首行时间与末行时间是否覆盖预期区间，检查中文字符是否乱码。
5. 测试 异常处理。拔掉 U 盘后再次点击按钮，观察 HMI 是否弹出 存储设备未找到 提示，确保脚本具备容错能力。

常见问题与排查

若报表生成失败，请对照下表逐一排查硬件与配置问题。

若需批量生成历史报表，可修改脚本中的 srcFile 路径为循环遍历模式，通过 For 循环读取特定日期范围内的所有日志文件，并合并输出至同一个 PDF 文档中。注意控制单次生成文件数量不超过 50 份，避免 HMI 内存溢出导致死机。