写标签 (Write Tag) | Mingcedar Studio

<div class="manual-doc-article manual-doc-article-section"><h2 id="interaction-write-tag">交互: 写标签 (Write Tag)</h2>

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

<div class="doc-card-list">

<article class="doc-card">

<h3 id="interaction-write-tag-item-1">功能说明</h3>

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

</article>

<article class="doc-card doc-card-tip">

<h3 id="interaction-write-tag-item-2">字段配置</h3>

<p>绑定后填写 Target Tag 和 Value，按需配置 Setup Script、Condition 和外观选项。</p>

<ul>

<li>Target Tag（目标标签）：要写入的标签名表达式。可直接填标签名，也可用模板占位实现复用；下方提示“按位写入请用 Bit Index”。</li>

<li>Value（值）：要写入的值，可以是单个表达式，也可以是用 return 返回结果的 JavaScript。初始值为 1。</li>

<li>Setup Script（准备脚本）：可选，先准备共享变量或辅助逻辑，供 Value 使用。</li>

<li>Condition（执行条件）：默认 true；计算结果为 false 时不执行写入。</li>

<li>选项：Show hand cursor when enabled（启用时显示手型光标）、Use bold border when enabled（启用时加粗边框）、Hide when disabled（未启用时隐藏）。</li>

</ul>

<div class="manual-code" data-code-language="javascript"><div class="manual-code-toolbar"><span>JavaScript</span><span class="manual-code-tools"><small>JavaScript</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: JavaScript">复制代码</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 style="color:#6A737D">// Setup Script</span></span>

<span class="line"><span style="color:#D73A49">var</span><span style="color:#24292E"> nextSetpoint </span><span style="color:#D73A49">=</span><span style="color:#005CC5"> 1200</span><span style="color:#24292E">;</span></span>

<span class="line"></span>

<span class="line"><span style="color:#6A737D">// Target Tag</span></span>

<span class="line"><span style="color:#005CC5">PLC_LINE01</span><span style="color:#24292E">.</span><span style="color:#005CC5">PUMP01</span><span style="color:#24292E">.</span><span style="color:#005CC5">SPEED_SETPOINT</span></span>

<span class="line"></span>

<span class="line"><span style="color:#6A737D">// Value（提交设定值）</span></span>

<span class="line"><span style="color:#24292E">nextSetpoint</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="interaction-write-tag-item-3">适用场景</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="interaction-write-tag-item-4">注意事项</h3>

<p>提交不代表写入成功，须核对宿主结果。</p>

<ul>

<li>Target Tag 字段填的是标签名表达式，不要把它当成“一定要加引号的字符串”；按编辑器约定填写标签名即可。</li>

<li>Value 如果是多行脚本，必须用 return 返回最终值，否则写不进去。</li>

<li>点击后可能没有立即生效：宿主机可能要权限校验、确认弹窗、异步写入或直接拒绝；宿主写入处理可能返回 Promise。</li>

<li>只改一个位时不要用本行为手动拼接整数，改用“写标签位 (Write Tag Bit)”更安全。</li>

</ul>

</article>

</div>

<div class="docs-note-grid manual-doc-image-grid">

<figure class="docs-note-card manual-doc-image-card" id="interaction-write-tag-image-1">

<img src="/WEB_img/HQPPT/current/write/write-normal.png" alt="Write Tag 写标签行为编辑器" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Write Tag 编辑器</strong>

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

</figcaption>

</figure>

</div>

</div>