314 技术参数在脚本与控制配置映射规则说明

版本: v1.1 修改日期: 2026-05-29

本文档说明 viSCADA 系统中脚本与控制配置引用技术参数的映射规则。阅读本文后，可掌握占位符语法与解析流程，并在 TOML、YAML 等配置中正确引用技术参数。

1 整体流程

图 1 技术参数占位符解析流程


${attribute.<key>}

要素	规则	说明
命名空间前缀	`attribute.`	固定写法，不可省略或替换
参数键名	`<key>`	目标技术参数的唯一标识符，对应技术参数配置列表中的 key
包裹符号	`${ ... }`	必须完整成对，替换时整体消失

ℹ️ 大小写敏感：参数键名的大小写以系统底层定义为准。配置时须与技术参数列表中的 key 精确匹配，大小写不一致将导致解析失败。

解析引擎对配置文本的处理遵循以下四个步骤：

ℹ️ ${attribute.<key>} 将被直接替换为技术参数中 <key> 对应的字符串值。

前置技术参数

参数键名	值
`address`	`127.0.0.1:4444`

脚本模板


urls = [
    "http://${attribute.address}/tags"
]

替换结果


urls = [
    "http://127.0.0.1:4444/tags"
]

ℹ️ 本示例演示技术参数与物模型属性上下文变量混用的场景。

前置条件

类型	键名	值
技术参数	`address`	`127.0.0.1:4444`
上下文变量	`tslProperty.name`	`b.b`

配置模板


url: "http://${attribute.address}/tag/${tslProperty.name?url('UTF-8')}"

替换结果


url: "http://127.0.0.1:4444/tag/b.b"

ℹ️ 上述 YAML 配置经系统解析执行后，device-server 日志中记录的实际 HTTP 请求如下：
httpPut: PUT http://127.0.0.1:4444/tag/b.b HTTP/1.1