跳至主要内容

写标签 (Write Tag)

点击组件向 Tag 提交值,适用于启停、设定值和复位;提交后须核对宿主写入结果。

交互文档修订:2026-10-21

交互: 写标签 (Write Tag)

点击组件向 Tag 提交值,适用于启停、设定值和复位;提交后须核对宿主写入结果。

功能说明

Write Tag 将值提交给 Mingcedar,由其执行权限、确认和写入处理。编辑预览不触发设备写入。仅修改整数的一位时使用 Write Tag Bit。

字段配置

绑定后填写 Target Tag 和 Value,按需配置 Setup Script、Condition 和外观选项。

  • Target Tag(目标标签):要写入的标签名表达式。可直接填标签名,也可用模板占位实现复用;下方提示“按位写入请用 Bit Index”。
  • Value(值):要写入的值,可以是单个表达式,也可以是用 return 返回结果的 JavaScript。初始值为 1。
  • Setup Script(准备脚本):可选,先准备共享变量或辅助逻辑,供 Value 使用。
  • Condition(执行条件):默认 true;计算结果为 false 时不执行写入。
  • 选项:Show hand cursor when enabled(启用时显示手型光标)、Use bold border when enabled(启用时加粗边框)、Hide when disabled(未启用时隐藏)。
JavaScriptJavaScript
// Setup Script
var nextSetpoint = 1200;

// Target Tag
PLC_LINE01.PUMP01.SPEED_SETPOINT

// Value(提交设定值)
nextSetpoint

适用场景

用于点击提交启停请求、设定值或复位。操作员输入可用 Input 模板,再按提交方式配置写入行为或 Click Script。

注意事项

提交不代表写入成功,须核对宿主结果。

  • Target Tag 字段填的是标签名表达式,不要把它当成“一定要加引号的字符串”;按编辑器约定填写标签名即可。
  • Value 如果是多行脚本,必须用 return 返回最终值,否则写不进去。
  • 点击后可能没有立即生效:宿主机可能要权限校验、确认弹窗、异步写入或直接拒绝;宿主写入处理可能返回 Promise。
  • 只改一个位时不要用本行为手动拼接整数,改用“写标签位 (Write Tag Bit)”更安全。
Write Tag 写标签行为编辑器
图示 1: Write Tag 编辑器

填目标标签和要写入的值,点击时向该标签写值,最终是否写成由宿主机决定。

再次点击图片或按 Esc 关闭