所属产品: Mingcedar Studio DESIGNER

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

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

首次发布 2026-10-25T12:48:42.601559271Z 最近更新 2026-10-25T12:48:42.60155847Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="runtime-data-export">数据导出: 运行时数据导出：JSON、表格与 Tag 当前值</h2>

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

<h3 id="runtime-data-export-item-1">1. 导出结构化 JSON</h3>

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

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span>ExportJson(</span></span>

<span class="line"><span> ReadTagJson("PLC_LINE01.REPORT01.SUMMARY", null),</span></span>

<span class="line"><span> "line01-production-summary.json"</span></span>

</article>

<h3 id="runtime-data-export-item-2">2. 导出当前页数据表格</h3>

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

<span class="line"><span>ExportTable("Line01ProductionTable", "line01-production.xlsx", "xlsx");</span></span></code></pre></div>

</article>

<h3 id="runtime-data-export-item-3">3. 导出 Tag 当前值与质量</h3>

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

<span class="line"><span> ["PLC_LINE01.PUMP01.SPEED", "PLC_LINE01.PUMP01.RUN"],</span></span>

<span class="line"><span> "line01-pump-status.json",</span></span>

</article>

<h3 id="runtime-data-export-item-4">4. 使用条件与结果含义</h3>

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

<ul>

<li>缺失表格、不可用 Tag 或不支持的格式会报告错误，不会自动替换为零值。</li>

<li>质量异常的已有 Tag 值保留质量标记，不能当作有效现场读数。</li>

<li>JSON 保留数值、布尔和空值的区别；表格导出使用其显示文本。</li>

<li>浏览器或宿主可能限制下载；发生失败时查看页面提示并检查下载权限。</li>

</ul>

</article>

</div>