文档手册

运行时数据导出：JSON、表格与 Tag 当前值

在 Click Script 中使用 ExportJson、ExportTable 或 ExportTags，将当前页面数据下载到操作员浏览器。该功能与制作阶段的 Export HTML 画面包导出用途不同。

数据导出文档修订：2026-10-21

数据导出: 运行时数据导出：JSON、表格与 Tag 当前值

在 Click Script 中使用 ExportJson、ExportTable 或 ExportTags，将当前页面数据下载到操作员浏览器。该功能与制作阶段的 Export HTML 画面包导出用途不同。

1. 导出结构化 JSON

ExportJson(value, fileName?) 导出对象、数组或其他可序列化值，默认文件名为 export.json。字符串按字符串保留；需要导出 JSON Tag 的结构化值时先用 ReadTagJson 读取。

ExportJson(
  ReadTagJson("PLC_LINE01.REPORT01.SUMMARY", null),
  "line01-production-summary.json"
);

2. 导出当前页数据表格

ExportTable(nameOrId, fileName?, format?) 支持当前页内置数据表格，格式为 csv、json、xlsx 或 excel（xlsx 别名），默认 CSV。第一个参数填写 Behavior Browser 中实际 Table 组件的 Name 或 shapeId，大小写须一致。为组件设置不重复的名称；Table name 字段只是显示标题，不能用于定位。导出当前数据绑定下的全部行，包括滚动区域之外的行，单元格保留显示文本。

ExportTable("Line01ProductionTable", "line01-production.csv", "csv");
ExportTable("Line01ProductionTable", "line01-production.xlsx", "xlsx");

3. 导出 Tag 当前值与质量

ExportTags(tagNames, fileName?, format?) 接受一个 Tag 名称或非空名称数组，支持 csv、json 和 xlsx，默认 CSV。导出当前值，不查询历史；CSV / XLSX 包含 Tag、Value、Quality，JSON 包含 name、value、quality。

ExportTags(
  ["PLC_LINE01.PUMP01.SPEED", "PLC_LINE01.PUMP01.RUN"],
  "line01-pump-status.json",
  "json"
);

4. 使用条件与结果含义

从用户点击动作发起下载，并确认数据已经加载且页面获准读取相关 Tag。返回文件名表示已发起下载，不表示文件已经保存到磁盘。文件下载到浏览器指定位置，不写入 Mingcedar 服务器目录。

缺失表格、不可用 Tag 或不支持的格式会报告错误，不会自动替换为零值。
质量异常的已有 Tag 值保留质量标记，不能当作有效现场读数。
JSON 保留数值、布尔和空值的区别；表格导出使用其显示文本。
浏览器或宿主可能限制下载；发生失败时查看页面提示并检查下载权限。