3.9 KiB

Raw Blame History

前端信号批量导出/导入 XML 功能

概述

在 5 个信号管理页面（out/in/yk/ao/param）的工具栏中新增"导出"和"导入"按钮，实现信号的批量导出到 XML 文件和从 XML 文件批量导入。

功能描述

导出：将当前页面已添加的信号列表生成为 XML 文件，通过浏览器下载
导入：读取本地 XML 文件，解析后按 seq 序号顺序逐个执行 add 操作

涉及文件

文件	修改类型	说明
`test/web_root/js/pages.js`	修改	主要逻辑变更
`src/system/libweb_server/src/packed_fs.c`	重新生成	`pack_web.sh` 打包输出

代码变更

1. 新增函数 `escapeXml(str)`

对 XML 特殊字符进行转义（& < > " '），用于拼接 XML 字符串时防止格式损坏。

2. 新增函数 `exportToXml(signalType, data)`

参数：signalType — 信号类型字符串，data — 信号数组
逻辑：
1. 空数据检查 → 弹窗提示
2. 拼接 XML 字符串（<?xml ...?> + <signals type="..."> + 逐个 signal 节点）
3. 输出字段：saddr、desc、data_type、val（全部 escapeXml 转义）
4. 创建 Blob → URL.createObjectURL → <a download> 触发下载
5. 文件名格式：signals_{type}_{timestamp}.xml
6. 清理：removeChild + revokeObjectURL

3. 新增函数 `importFromXml(signalType)`

参数：signalType — 当前页面信号类型
逻辑：
1. 创建隐藏 <input type="file" accept=".xml"> 并触发点击
2. 文件选中后用 FileReader 读取文本
3. DOMParser 解析 XML
4. 校验：根元素必为 <signals>，type 属性必须与 signalType 一致
5. 提取所有 <signal> 节点的 <saddr>，按 seq 属性升序排序
6. confirm 确认后，逐个发送 WsClient.send add 命令
7. 完成后 alert 提示结果

4. 修改函数 `makeToolbar(signalType, showSet)`

在工具栏末尾添加两个按钮：

<span style="flex:1"></span> — 弹性撑开
<button class="btn btn-info" id="tb-export">📤 导出</button>
<button class="btn btn-warn" id="tb-import">📥 导入</button>

5. 修改函数 `bindToolbar(signalType, getDataFn)`

参数变更：第二个参数从 data 数组改为 getter 函数 getDataFn
导出按钮：onclick 调用 getDataFn() 获取最新数据，传给 exportToXml
导入按钮：onclick 直接调用 importFromXml(signalType)

6. 修改各页面调用

5 个页面均传递 getter 函数解决数据引用过时问题：

bindToolbar('out', function() { return data; });

XML 格式

<?xml version="1.0" encoding="UTF-8"?>
<signals type="out">
    <signal seq="1">
        <saddr>iec.run_cnt</saddr>
        <desc>运行计数</desc>
        <data_type>INT32</data_type>
        <val>0</val>
    </signal>
</signals>

根元素 type 标记信号类型，导入时校验是否匹配当前页面
desc、data_type、val 为参考字段，导入时忽略（仅使用 saddr）

构建注意事项

Web 服务使用 packed_fs.c（通过 release/pack_web.sh 将 test/web_root/ 打包为 C 字节数组）。修改前端文件后需要：

cd release && bash pack_web.sh    # 重新打包
rm -f x86/lib/libweb_server.a     # 删除旧库
make -C src/system/libweb_server  # 重新编译 web_server 库
make                               # 重新链接 RTU
cp x86/exe/RTU ../test/           # 复制到运行目录

验证结果

验证项	结果
5 个页面均有导出/导入按钮	✅
导出按钮响应点击（空数据提示）	✅
导出按钮触发文件下载（有数据时）	✅（代码审查确认）
导入按钮弹出文件选择对话框	✅
XML 解析逻辑正确	✅（代码审查确认）
发送 add 命令逻辑正确	✅（代码审查确认）
编译通过	✅

3.9 KiB Raw Blame History Unescape Escape