帮助中心Appearance
$setCommand — OPGview 控制指令参考
版本：v3.14+ | 适用项目：OPGview / OPScada
控制指令统一入口，支持实时写入、挂牌、脉冲、报警抑制、强制命令等多种模式。
目录
快速示例
js
// 写实时 — 无验证
$setCommand({ model:'RT', check:'OFF', gns:'W3.T.AX1', avs:1 })
// 写控制 — 单点 + 账号密码验证
$setCommand({ model:'CONTROL', check:'USER', gns:'W3.T.AX1', avs:1 })
// 多点控制 — 一组多个点
$setCommand({ model:'CONTROL', check:'USER', gns:'W3.T.AX1,W3.T.AX2', avs:1 })
// 多组控制 — 不同组不同值
$setCommand({ model:'CONTROL', check:'USER', gns:['W3.T.AX1,W3.T.AX2','W3.T.DX1'], avs:[11,0] })
// 脉冲 — 控制后自动恢复
$setCommand({ model:'PULSE', check:'USER', gns:'W3.DATAPOINT.AX2', avs:1, secondValue:0, interval:1000 })
// 自定义校验文字 + 双密码
$setCommand({ gns:'W3.SYS.LOAD', avs:1, check:'TEXT_TWOUSER', model:'CONTROL', check102:"确认文字" })
// 自定义描述
$setCommand({ model:'CONTROL', check:'USER', gns:'W3.T.AX1', avs:1, eds:'这是自定义描述' })
// 下发前预处理（值乘以10）
$setCommand({ model:'RT', check:'USER', gns:'W3.T.AX1', avs:1, beforeSend:"AV*10" })
// 使用第2套控制代理
$setCommand({ model:'CONTROL', check:'OFF', gns:'W3.T.AX1', avs:1, controlServeice:'2' })必要参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
model | string | 指令类型，见下方模式定义 | 'CONTROL' |
check | string | 验证模式，见下方验证模式 | 'USER' |
gns | string/string[] | 测点全名 | 单点: 'W3.T.AX1'；多点: 'W3.T.AX1,W3.T.AX2'；多组: ['W3.T.AX1,W3.T.AX2', 'W3.T.DX1'] |
avs | number/number[] | 预设值，与 gns 对应 | 单组: 1；多组: [11, 0] |
gns/avs 对应关系：几组 gns 就需要几组 avs。脉冲(PULSE)、挂牌(PADLOCK)、强制(FORCE_ON/OFF) 不支持多组数据。
扩展参数
| 参数 | 类型 | 说明 |
|---|---|---|
eds | string/string[] | 自定义描述文本，与 gns 对应 |
secondValue | number | 脉冲模式时的第二个值（恢复值） |
interval | number | 脉冲间隔，单位毫秒（如 1000 = 1秒） |
check101 | string | TEXT_USER 模式时要求输入的文字 |
check102 | string | TEXT_TWOUSER 模式时要求输入的文字 |
beforeSend | string | 预处理表达式，AV 代表输入值。如 "AV*10" 下发值为输入值 ×10 |
pointInfo | object | 自定义测点信息，如 {"W3.TEST.TEST":{"ED":"测试点","GN":"W3.TEST.TEST","RT":1}} |
autoPointInfo | boolean | 自动生成 pointInfo（简易模式，推荐手动配置 pointInfo） |
checkCtrlAuth | boolean | 强制验证节点控制权限（CONTROL / PULSE 模式可用） |
controlServeice | string | 控制代理套数："1"(默认)、"2"、"3"、"4"，不传则使用全局配置 |
showTip | boolean | 是否显示反馈信息，默认 true |
readonly | boolean | 弹窗中预设值是否允许修改，默认 false |
title | string | 自定义弹窗标题 |
模式定义
| mode | 说明 | 支持多组点 | 特殊参数 |
|---|---|---|---|
RT | 写实时 | ✓ | — |
CONTROL | 写控制 | ✓ | checkCtrlAuth |
PULSE | 脉冲控制（下发后延时恢复） | ✗ | secondValue, interval, checkCtrlAuth |
PADLOCK | 挂牌命令 | ✗ | — |
INHIBIT | 报警抑制 | ✓ | — |
FORCE_ON | 强制命令 | ✗ | — |
FORCE_OFF | 取消强制命令 | ✗ | — |
验证模式
| check | 说明 | 弹窗要求 |
|---|---|---|
OFF | 无验证 | 仅确认操作 |
CONFIRM | 确认操作 | 点击确认按钮 |
KR | 设备码验证 | 输入设备码(KR) |
USER | 验证账号密码 | 输入用户名 + 密码 |
PASSWORD | 验证密码 | 输入当前用户密码 |
TWOUSER | 双人验证 | 两个不同账号 + 密码 |
TEXT_USER | 自定义文字 + 单密码 | 输入指定文字 + 账号密码（需 check101） |
TEXT_TWOUSER | 自定义文字 + 双密码 | 输入指定文字 + 双人账号密码（需 check102） |
回调函数
js
$setCommand(options, function(isSuccess, data) {
if (isSuccess) {
console.log('控制成功', data)
// 可以链式调用下一个指令
$setCommand({ model:'RT', check:'OFF', gns:'W3.T.AX2', avs:0 })
}
})isSuccess:true表示控制成功data: 返回信息对象，包含Msg等字段- 第二个参数为
function时自动识别为回调
控制代理多源
系统支持配置最多 4 套 控制代理地址。在配置管理 → 服务器配置 → 控制代理配置中，通过"当前编辑套数"下拉框切换编辑。
| 套数 | 主键 | 第2套 | 第3套 | 第4套 |
|---|---|---|---|---|
| IP | controlIP | controlIP_2 | controlIP_3 | controlIP_4 |
| 端口 | controlPORT | controlPORT_2 | controlPORT_3 | controlPORT_4 |
| 账号 | controlUSER | controlUSER_2 | controlUSER_3 | controlUSER_4 |
| 密码 | controlPWD | controlPWD_2 | controlPWD_3 | controlPWD_4 |
| 超时 | controlTimeout | controlTimeout_2 | controlTimeout_3 | controlTimeout_4 |
js
// 指定使用第2套控制代理
$setCommand({ model:'CONTROL', check:'OFF', gns:'W3.T.AX1', avs:1, controlServeice:'2' })
// 不指定 → 自动使用全局配置的 controlServeice (默认 "1")
$setCommand({ model:'CONTROL', check:'OFF', gns:'W3.T.AX1', avs:1 })完整参数速查表
| 参数 | 类型 | 默认值 | 必填 | 适用模式 | 说明 |
|---|---|---|---|---|---|
model | string | — | ✓ | 全部 | RT/CONTROL/PULSE/PADLOCK/INHIBIT/FORCE_ON/FORCE_OFF |
check | string | — | ✓ | 全部 | OFF/CONFIRM/KR/USER/PASSWORD/TWOUSER/TEXT_USER/TEXT_TWOUSER |
gns | string/string[] | — | ✓ | 全部 | 测点全名 |
avs | number/number[] | — | ✓ | 全部 | 预设值 |
eds | string/string[] | — | 全部 | 自定义描述 | |
secondValue | number | — | PULSE | 脉冲恢复值 | |
interval | number | — | PULSE | 脉冲间隔(毫秒) | |
check101 | string | — | TEXT_USER | 需确认的文字 | |
check102 | string | — | TEXT_TWOUSER | 需确认的文字 | |
beforeSend | string | — | RT/CONTROL | 值预处理表达式 | |
pointInfo | object | — | 全部 | 自定测点信息 | |
autoPointInfo | boolean | false | 全部 | 自动生成 pointInfo | |
checkCtrlAuth | boolean | false | CONTROL/PULSE | 强制验证节点权限 | |
controlServeice | string | "1" | 全部 | 控制代理套数 | |
showTip | boolean | true | 全部 | 显示反馈信息 | |
readonly | boolean | false | 全部 | 预设值只读 | |
title | string | — | 全部 | 弹窗标题 |