内置输入模板：三种模式，先按数据目标选择 | Mingcedar Studio

<section id="input-template" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">Input</span> <h2>内置输入模板：三种模式，先按数据目标选择</h2> <p>Input 支持 Plain Input、Runtime Variable、PLC Tag。按输入用途选择模式；名称字段直接填名称，脚本中的字符串参数加引号。</p> <div class="docs-detail-list"> <article id="input-template-item-1" class="docs-detail-row"> <strong>Plain Input 模式：先只收输入，不自动写标签</strong> <p>Plain Input 暂存输入，不填写 PLC Tag，也不自动写设备。脚本通过 template.getValue(&quot;Input Template&quot;) 读取，参数为输入实例名。</p> <ul> <li>适合先输入、后确认的场景</li><li>适合需要脚本二次判断的场景</li><li>适合页面暂存输入，不直接写设备</li> </ul> <pre class="docs-code-block"><code>var recipeName = template.getValue(&quot;Input Template&quot;);

if (recipeName !== &quot;&quot;) {

WriteTagString(&quot;PLC_LINE01.PUMP01.RECIPE&quot;, recipeName);

}</code></pre> </article><article id="input-template-item-2" class="docs-detail-row"> <strong>Runtime Variable 模式：输入结果先进入运行时变量</strong> <p>Runtime Variable 保存当前页输入。固定目标填 speedSetpointDraft，不加引号；动态目标填 =selectedVariableName，须返回有效变量名。Set Variable on Click 的 Variable 仍填赋值目标名，两者规则不同。</p> <ul> <li>适合页面内联动</li><li>适合局部筛选和局部状态切换</li><li>适合暂存值，后续再统一处理</li><li>配置框示例：recipeName，不是 &quot;recipeName&quot;</li> </ul> </article><article id="input-template-item-3" class="docs-detail-row"> <strong>PLC Tag 模式：输入后直接面向设备或系统值</strong> <p>PLC Tag 固定目标填 PLC_LINE01.PUMP01.SPEED_SETPOINT，模板目标填 &lt;PLC&gt;.PUMP01.SPEED_SETPOINT，动态目标填 =selectedSetpointTag 并返回完整名称。此字段不填读取或写入调用；计算 Tag 不可写入。</p> <ul> <li>适合设定值和参数值</li><li>适合明确要写 PLC 的输入项</li><li>固定目标：PLC_LINE01.PUMP01.SPEED_SETPOINT；动态目标：=selectedSetpointTag。</li><li>关键操作建议配合确认和权限规则一起考虑</li> </ul> </article><article id="input-template-item-4" class="docs-detail-row"> <strong>输入值类型处理</strong> <p>PLC Tag 模式识别数字、布尔和字符串。自定义上下限须用 Plain Input 配合按钮校验后写入；单位、范围提示和确认框不执行校验。</p> </article><article id="input-template-item-5" class="docs-detail-row"> <strong>确认动作放置位置</strong> <p>范围校验、原因填写和组合写入由 Plain Input 配合按钮或 Click Script 完成。Keypad OK 不会调用另一按钮的校验。</p> </article><article id="input-template-item-6" class="docs-detail-row"> <strong>字段与脚本的引号规则</strong> <p>Input 固定目标、Runtime Variable 名称和模板占位符不加引号；= 表示求值后使用返回名称。JavaScript 名称参数加引号，如 template.getValue(&quot;SpeedSetpointInput&quot;)。</p> <ul> <li>固定 PLC Tag：PLC_LINE01.PUMP01.SPEED_SETPOINT。</li><li>模板 PLC Tag：&lt;PLC&gt;.PUMP01.SPEED_SETPOINT。</li><li>Runtime Variable：speedSetpointDraft；动态变量名：=selectedVariableName。</li><li>脚本读取输入框：template.getValue(&quot;SpeedSetpointInput&quot;)。</li><li>脚本读取 Tag：ReadTagDouble(&quot;PLC_LINE01.PUMP01.SPEED&quot;, 0)。</li> </ul> </article><article id="input-template-item-7" class="docs-detail-row"> <strong>写入触发方式选择</strong> <p>需先校验再写入时，使用 Plain Input 和独立按钮。PLC Tag Input 按自身规则提交，另一按钮不能拦截 Keypad OK。</p> </article> </div> <div class="docs-note-grid"> <figure id="input-template-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/TemplateInstanceEditorFormInput.png" alt="输入模板实例" loading="lazy" decoding="async"> <figcaption> <strong>输入模板实例</strong> <p>输入模板应先选清楚 Plain Input、Runtime Variable 或 PLC Tag，再决定是否由脚本统一提交。</p> </figcaption> </figure> </div> </section>