跳至主要内容

Open Diagnosis 打开诊断

点击组件,请求 Mingcedar 打开对应设备的诊断弹窗。

交互文档修订:2026-10-21

交互: Open Diagnosis 打开诊断

点击组件,请求 Mingcedar 打开对应设备的诊断弹窗。

功能说明

将 Open Diagnosis 绑定到设备图形。诊断窗口由 Mingcedar 提供,须在已配置诊断模板的 Mingcedar 中验证;本地 HTML 无法验证。

字段配置

除 Setup Script 和 Condition 外,填写 Popup Target 的四个参数,均为 JavaScript 字符串表达式,可用常量或动态拼接。界面标签与宿主参数对应如下:

  • Setup Script:准备逻辑。可在这里读标签、定义变量,供下面字段引用(如 var dev = 'F01';)。
  • PLC:目标所在的 PLC / 设备站名(对应载荷 PLC)。默认 'PLC'。
  • Template(对应载荷 ID):宿主中诊断模板的编码,决定加载哪个模板。默认 'device-default'。
  • Status Prefix(对应载荷 DiagnosisControl):设备状态 Tag 的前缀,宿主将它与 PLC 和模板后缀组合为完整 Tag 名称。默认空 ''。
  • Title(对应载荷 GroupRightIndex):弹窗显示的设备名称或标题,不参与状态 Tag 前缀拼接。默认 'ObjectName'。
  • Condition(对应载荷 Enabled):是否允许触发的开关,true 才会执行,false 则点击不弹窗。默认 true。
  • 模板实例可直接填写 '<PLC>'、'<DIAGNOSIS_TEMPLATE>'、'<STATUS_PREFIX>'、'<TITLE>' 等字符串占位;保存后由模板实例替换。
JavaScriptJavaScript
// Setup Script
var deviceId = 'PUMP_01';

// 各目标字段(字符串表达式)
PLC:           'PLC_LINE01'
Template(ID):  'device-default'
Status Prefix(DiagnosisControl): 'AREA01.PUMP01'   // 状态 Tag 前缀
Title(GroupRightIndex):          deviceId         // 标题显示 PUMP_01
Condition(Enabled):              true

// 运行时等价于:
hqVisuDesigner.openDiagnosis({
  PLC: 'PLC_LINE01', ID: 'device-default',
  DiagnosisControl: 'AREA01.PUMP01',
  GroupRightIndex: 'PUMP_01'
});

适用场景

在设备总览页点击泵、阀或电机查看诊断。复用模板时,可在 Setup Script 中按所选设备生成目标。

注意事项

  • Status Prefix / DiagnosisControl 填状态 Tag 前缀。例如 PLC 填 PLC_LINE01、Status Prefix 填 AREA01.PUMP01,模板后缀为 RUN 时,完整 Tag 为 PLC_LINE01.AREA01.PUMP01.RUN。Title / GroupRightIndex 只用于显示设备名称。
  • 编辑器里看到的标签(Template / Status Prefix / Title)与传给宿主机的参数名(ID / DiagnosisControl / GroupRightIndex)不是同一个词,排错时按上面的对应关系看。
  • 四个目标字段是字符串表达式:写常量要带引号(如 'PLC1'),写动态值才用变量名(如 dev)。
  • Condition / Enabled 为 false 时点击不会有任何反应,调试“点了没弹窗”时先确认它没被关掉。
  • 弹窗由宿主机打开,效果取决于宿主机是否配置了对应的诊断模板(Template / ID);脱离 Mingcedar 宿主机时不生效。
Open Diagnosis 打开诊断行为编辑器
图示 1: Open Diagnosis 编辑器

填 PLC、Template、Status Prefix、Title 等目标参数,点击时请求宿主机弹出设备诊断窗口。

再次点击图片或按 Esc 关闭