所属产品: Mingcedar Studio DESIGNER

通用选项：数据质量、条件与隐藏 | Mingcedar Studio

说明数据质量提示、Condition 的不同含义，以及各类隐藏选项。配置项以对应行为编辑器为准。

首次发布 2026-10-25T12:48:42.60827524Z 最近更新 2026-10-26T19:56:55.621978724Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="shared-options-quality-border-active-post-operations">功能: 通用选项：数据质量、条件与隐藏</h2>

说明数据质量提示、Condition 的不同含义，以及各类隐藏选项。配置项以对应行为编辑器为准。

<h3 id="shared-options-quality-border-active-post-operations-item-1">数据质量与显示状态</h3>

<p>数据质量表示 Tag 数据是否有效，与运行、停止、报警等工艺状态分别处理。以 Script Text 为例，在 Quality Override 中勾选 Use quality outline colors，并分别设置 Good、Bad 颜色。State Color 对应选项为 Follow data quality (border / hide)，并可配置质量异常时隐藏。</p>

<li><a href="/ppt/manual/script-text/">Script Text</a></li>

<li><a href="/ppt/manual/state-color/">State Color</a></li>

</ul>

</article>

<h3 id="shared-options-quality-border-active-post-operations-item-2">Condition 的含义</h3>

<p>Condition 的作用随行为而异，按下表及对应编辑器配置。</p>

<p class="doc-table-hint">左右滑动查看完整表格</p>

<thead><tr><th scope="col">行为</th><th scope="col">Condition 的作用</th></tr></thead><tbody>

<tr><th scope="row">State Color</th><td>按条件选择已启用的 TRUE 或 FALSE 外观；FALSE 需在 Apply result 中启用，false 不等于停止显示。</td></tr>

<tr><th scope="row">Script Text</th><td>控制该条文本行为是否执行。</td></tr>

<tr><th scope="row">Set Variable on Click / Write Tag</th><td>控制本次用户操作是否执行；false 时跳过。</td></tr>

<tr><th scope="row">Move / Rotate / Scale</th><td>控制该条几何行为是否生效；数值来源另填 Source value 或 Rotation input。</td></tr>

</tbody></table></div>

</article>

<h3 id="shared-options-quality-border-active-post-operations-item-3">三类隐藏选项</h3>

<p class="doc-table-hint">左右滑动查看完整表格</p>

<thead><tr><th scope="col">选项</th><th scope="col">触发条件与范围</th></tr></thead><tbody>

<tr><th scope="row">Hide when quality is bad</th><td>关联数据质量异常时隐藏；在提供该选项的显示行为中配置。</td></tr>

<tr><th scope="row">Hide when disabled</th><td>条件不满足时隐藏；例如 Set Variable on Click。未勾选时，跳过操作不代表隐藏组件。</td></tr>

<tr><th scope="row">Hide outside range / Hide outside rotation range</th><td>Move / Rotate 的输入值超范围时隐藏；Scale 当前没有此选项。</td></tr>

</tbody></table></div>

</article>

<h3 id="shared-options-quality-border-active-post-operations-item-4">表达式与验证</h3>

<p>例如，在 Script Text 的 Condition 中填写下方表达式，仅在指定 Tag 质量良好时执行文本行为。将示例名称替换为项目中的 Tag，分别验证质量正常和异常时的结果。需要持续显示质量提示时，应同时配置对应 Quality Override。</p>

<ul>

<li>Condition 应立即返回布尔值，不使用 fetch、Promise 或定时器。</li>

<li>Condition 不能替代 Mingcedar 的写入权限和设备联锁。</li>

<li>Move / Rotate / Scale 当前没有单独的 Post Operations 输入框。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Script Text → Condition</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Script Text → Condition">复制代码</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>ReadTagQualityGood("PLC_LINE01.PUMP01.SPEED")</span></span></code></pre></div>

</article>

</div>