$setCommand

OPGview 控制指令参考手册 · v3.14+ · 可交互

指令构造器

选择参数自动生成 $setCommand 调用代码

model 模式必填

check 验证必填

gns / avs 必填

avs →

脉冲/挂牌/强制不支持多组

eds 描述

controlServeice

showTip

readonly

生成结果

请填写 gns 和 avs

📋 历史记录

参数速查

参数	类型	默认值	必填	适用模式	说明
`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[]	—	✓	全部	预设值，与 gns 一一对应
`eds`	string/string[]	—		全部	自定义描述文本
`secondValue`	number	—		PULSE	脉冲恢复值
`interval`	number	—		PULSE	脉冲间隔（毫秒）
`check101`	string	—		TEXT_USER	需确认的文字内容
`check102`	string	—		TEXT_TWOUSER	需确认的文字内容
`beforeSend`	string	—		RT/CONTROL	值预处理表达式，AV=输入值
`pointInfo`	object	—		全部	自定义测点信息映射
`autoPointInfo`	boolean	false		全部	自动生成 pointInfo（建议手动配置）
`checkCtrlAuth`	boolean	false		CONTROL/PULSE	强制验证节点控制权限
`controlServeice`	string	"1"		全部	控制代理套数：1/2/3/4
`showTip`	boolean	true		全部	是否显示反馈信息弹窗
`readonly`	boolean	false		全部	弹窗中预设值是否只读
`title`	string	—		全部	自定义弹窗标题

基础示例

写实时 — 无需验证

$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','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:"确认操作" })

下发前预处理 — 值乘以10

$setCommand({ model:'RT', check:'USER', gns:'W3.T.AX1', avs:1, beforeSend:"AV*10" })

自定义测点信息

$setCommand({ model:'CONTROL', check:'USER', gns:'W3.T.AX1', avs:1, pointInfo:{"W3.T.AX1":{ED:"测试点",GN:"W3.T.AX1",RT:1}} })

链式调用 — 回调中执行下一个指令

$setCommand({ model:'RT', check:'USER', gns:'W3.GSZ.Y1C147', avs:1 }, function(isSuccess, data) { if (isSuccess) { $setCommand({ model:'RT', check:'OFF', gns:'W3.GSZ.Y1C147', avs:0 }) } })

指定第2套控制代理

$setCommand({ model:'CONTROL', check:'OFF', gns:'W3.T.AX1', avs:1, controlServeice:'2' })

报警抑制

$setCommand({ gns:'W3.ALARM.A_A', avs:1, check:'USER', model:'INHIBIT', readonly:true })

模式详解 (model)

值	名称	多组点	特殊参数	说明
`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)

控制代理多源

支持最多 4 套控制代理地址，通过下拉框切换编辑，$setCommand 可指定使用哪套。

配置位置

配置管理 → 服务器配置 → 控制代理配置 → "当前编辑套数" 下拉框

配置键映射

	第1套(默认)	第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`

使用示例

// 指定第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 })

优先级规则

调用时显式传入的 controlServeice → 最高优先级
全局配置 controlServeice（配置文件中设置的值）
默认 "1"（第1套 / 主配置）