交互: 写标签 (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)”更安全。
图示 1: Write Tag 编辑器
填目标标签和要写入的值,点击时向该标签写值,最终是否写成由宿主机决定。