内置输入模板:三种模式,先按数据目标选择 | HQ VISU Designer

input 模板是操作区里最基础也最常用的模板之一。它支持 Plain Input、Runtime Variable 和 PLC Tag 三种模式。先决定输入结果的目标位置,再决定配置框里填什么;配置框里通常填名称本身,脚本里才按 JavaScript 规则给字符串加引号。

模板方法Input
Input

内置输入模板:三种模式,先按数据目标选择

input 模板是操作区里最基础也最常用的模板之一。它支持 Plain Input、Runtime Variable 和 PLC Tag 三种模式。先决定输入结果的目标位置,再决定配置框里填什么;配置框里通常填名称本身,脚本里才按 JavaScript 规则给字符串加引号。

Plain Input 模式:先只收输入,不自动写标签

如果只是希望先收集一个输入值,后续再由脚本决定处理方式,优先使用 Plain Input。这个模式不填写 PLC Tag,也不自动写设备;输入框当前值通过 template.getValue("输入模板实例名") 读取。例如实例名为 Input Template,就写 template.getValue("Input Template")。

  • 适合先输入、后确认的场景
  • 适合需要脚本二次判断的场景
  • 适合页面暂存输入,不直接写设备
var recipeName = template.getValue("Input Template");
if (recipeName !== "") {
  WriteTagString("Device.RECIPE", recipeName);
}
Runtime Variable 模式:输入结果先进入运行时变量

如果输入值主要用于页面内联动、模板联动、局部状态切换,而不是直接下发给 PLC,适合使用 Runtime Variable。配置 Runtime Variable 字段时填变量名本身,例如 recipeName 或 selectedPump,不写成 "recipeName",也不写脚本表达式。

  • 适合页面内联动
  • 适合局部筛选和局部状态切换
  • 适合暂存值,后续再统一处理
  • 配置框示例:recipeName,不是 "recipeName"
PLC Tag 模式:输入后直接面向设备或系统值

如果输入框的目标就是 PLC Tag,应使用 PLC Tag 模式。PLC Tag 字段填完整点名本身,例如 Device.TAGNAME,不写成 "Device.TAGNAME",也不写 ReadTagString("Device.TAGNAME")。模板会按输入值类型走对应写入链。

  • 适合设定值和参数值
  • 适合明确要写 PLC 的输入项
  • 配置框示例:Device.TAGNAME,不是 "Device.TAGNAME"
  • 关键操作建议配合确认和权限规则一起考虑
输入值类型处理

PLC Tag 模式会按输入内容识别数字、布尔或字符串。参数设定类输入建议在页面上同时给出单位、范围和当前值;需要严格限制上下限时,应在输入前后结合脚本或写值确认规则处理。

确认动作放置位置

输入模板只负责收集或提交一个值。需要二次确认、权限判断、原因填写或组合写入时,建议让输入模板先保存值,再由按钮行为、Keypad 的 OK 或 Click Script 统一触发后续动作。

字段与脚本的引号规则

固定点名可以按字段原有格式填写;只要点名中包含模板变量,就应写成字符串。Runtime Variable 字段填运行时变量名本身,例如 recipeName;脚本方法参数按 JavaScript 字符串规则加引号,例如 template.getValue("Input Template")。

  • 固定 PLC Tag:Device.TAGNAME
  • 模板 PLC Tag:'<PLC>.TAGNAME' 或 "<PLC>.TAGNAME"
  • Runtime Variable:recipeName
  • 脚本读取输入框:template.getValue("Input Template")
  • 脚本读取 Tag:ReadTagString("Device.TAGNAME", "")
写入触发方式选择

如果用户输入后需要再确认一次,就让输入模板先保存值,由按钮、keypad 的 OK 或脚本统一触发;如果输入完成就应该立刻提交,再考虑直接绑定写入。对工业项目来说,越关键的写入越不建议“输入即提交”。

输入模板实例
输入模板实例

输入模板应先选清楚 Plain Input、Runtime Variable 或 PLC Tag,再决定是否由脚本统一提交。