Tag Text | Mingcedar Studio

<div class="manual-doc-article manual-doc-article-section"><h2 id="text-tag-text">Text: Tag Text</h2>

Display one Tag value with an optional fallback, prefix, suffix and quality border.

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

<article class="doc-card">

<h3 id="text-tag-text-item-1">What it is and what it&#39;s for</h3>

<p>Bind Tag Text to a text component and set its target and optional prefix/suffix. Use Script Text for calculations or combined values.</p>

</article>

<article class="doc-card">

<h3 id="text-tag-text-item-2">Field configuration</h3>

<p>Open Tag Text and configure these fields:</p>

<ul>

<li>Target tag: enter the full name PLC_LINE01.OVEN01.TEMPERATURE directly. Quoted names, name-string variables, and =bindingConfig.temperatureTag are also supported. The target must be a name string; no read method is required.</li>

<li>Fallback value: the fallback text shown when the tag has no value; defaults to an empty string.</li>

<li>Prefix: text placed before the value, e.g. &quot;Temperature: &quot;.</li>

<li>Suffix: text placed after the value, e.g. &quot; °C&quot;.</li>

<li>Use quality outline colors: enable a quality border. Good communication quality uses the Good color (default #000000); bad quality uses the Bad color (default #FF8800).</li>

</ul>

<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="Copied" data-failed="Select and copy the code" aria-label="Copy code: Text">Copy code</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>Target tag: PLC_LINE01.OVEN01.TEMPERATURE</span></span>

<span class="line"><span>Fallback value: "--"</span></span>

<span class="line"><span>Prefix: "Temperature: "</span></span>

<span class="line"><span>Suffix: " °C"</span></span>

<span class="line"><span>// Display example: Temperature: 36.5 °C</span></span></code></pre></div>

</article>

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

<h3 id="text-tag-text-item-3">When to use it</h3>

<p>Use for a direct single-Tag display, for example:</p>

<ul>

<li>Show a measured value (temperature, pressure, level, flow) with its unit directly on the screen.</li>

<li>Display a string tag such as a device operating-mode name or batch number.</li>

<li>If the text needs multiple tags, conditional logic, or formatting, use Script Text instead.</li>

</ul>

</article>

<article class="doc-card">

<h3 id="text-tag-text-item-4">Limitations and troubleshooting</h3>

<p>A fixed full name in Target tag does not require quotes. Use =bindingConfig.temperatureTag for an object property. Fallback value, Prefix, and Suffix are string expressions: quote literal text. Use Script Text for numeric variables, formatted results, or calculated Tags. Quality Border indicates data quality, not equipment state or alarms.</p>

</article>

</div>

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

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

<img src="/WEB_img/HQPPT/current/text/tag-text.png" alt="Tag Text behavior editor" loading="lazy" decoding="async" />

<figcaption>

<strong>Figure 1: Tag Text editor</strong>

<p>Fill the tag expression, default value, and optional prefix/suffix to show a single tag&#39;s value as text.</p>

</figcaption>

</figure>

</div>

</div>