本文档说明 viSCADA 系统中脚本与控制配置引用技术参数的映射规则,适用于设备接入开发者与配置工程师。阅读本文后,你将掌握占位符的语法、解析流程,并能够在 TOML、YAML 等配置中正确引用技术参数。

1 核心机制概述

viSCADA 通过动态占位符替换机制,实现配置项对技术参数的灵活绑定。解析引擎在脚本执行或配置下发前,会将文本中符合特定语法的占位符替换为技术参数的实际值。

2 占位符语法规则

2.1 标准格式

${attribute.<key>}

2.2 语法要素说明

⚠️ 大小写敏感性:参数键名的大小写处理以系统底层定义为准。为避免解析失败,配置时务必与技术参数列表中的 key 保持精确匹配。

3 解析流程

解析引擎对配置文本的处理遵循以下四个阶段:

💡 核心逻辑:${attribute.<key>} 将被直接替换为技术参数中 <key> 对应的字符串值。

4 应用示例

4.1 示例 A:脚本参数注入(TOML)

前置技术参数

脚本模板

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

替换结果

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

4.2 示例 B:控制配置动态 URL 生成(YAML)

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

前置条件

配置模板

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

5 常见问题