跳至主要内容

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

Input 支持 Plain Input、Runtime Variable、PLC Tag。按输入用途选择模式;名称字段直接填名称,脚本中的字符串参数加引号。

模板方法Input
Input

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

Input 支持 Plain Input、Runtime Variable、PLC Tag。按输入用途选择模式;名称字段直接填名称,脚本中的字符串参数加引号。

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

Plain Input 暂存输入,不填写 PLC Tag,也不自动写设备。脚本通过 template.getValue("Input Template") 读取,参数为输入实例名。

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

Runtime Variable 保存当前页输入。固定目标填 speedSetpointDraft,不加引号;动态目标填 =selectedVariableName,须返回有效变量名。Set Variable on Click 的 Variable 仍填赋值目标名,两者规则不同。

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

PLC Tag 固定目标填 PLC_LINE01.PUMP01.SPEED_SETPOINT,模板目标填 <PLC>.PUMP01.SPEED_SETPOINT,动态目标填 =selectedSetpointTag 并返回完整名称。此字段不填读取或写入调用;计算 Tag 不可写入。

  • 适合设定值和参数值
  • 适合明确要写 PLC 的输入项
  • 固定目标:PLC_LINE01.PUMP01.SPEED_SETPOINT;动态目标:=selectedSetpointTag。
  • 关键操作建议配合确认和权限规则一起考虑
输入值类型处理

PLC Tag 模式识别数字、布尔和字符串。自定义上下限须用 Plain Input 配合按钮校验后写入;单位、范围提示和确认框不执行校验。

确认动作放置位置

范围校验、原因填写和组合写入由 Plain Input 配合按钮或 Click Script 完成。Keypad OK 不会调用另一按钮的校验。

字段与脚本的引号规则

Input 固定目标、Runtime Variable 名称和模板占位符不加引号;= 表示求值后使用返回名称。JavaScript 名称参数加引号,如 template.getValue("SpeedSetpointInput")。

  • 固定 PLC Tag:PLC_LINE01.PUMP01.SPEED_SETPOINT。
  • 模板 PLC Tag:<PLC>.PUMP01.SPEED_SETPOINT。
  • Runtime Variable:speedSetpointDraft;动态变量名:=selectedVariableName。
  • 脚本读取输入框:template.getValue("SpeedSetpointInput")。
  • 脚本读取 Tag:ReadTagDouble("PLC_LINE01.PUMP01.SPEED", 0)。
写入触发方式选择

需先校验再写入时,使用 Plain Input 和独立按钮。PLC Tag Input 按自身规则提交,另一按钮不能拦截 Keypad OK。

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

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

再次点击图片或按 Esc 关闭