5.4 变量-转发配置

# 变量管理-转发配置

DGather的主要作用是数据IOT，即将数据从数据源采集过来，处理之后再将数据发送到目的地址。而配置完变量的采集参数才完成了第一步，还应再配置数据的转发参数。
* 可以为每一个变量配置不同的转发参数
* 同一个变量可以转发到多个目的地
* 如果为变量设置了允许历史存储，则每次触发存储策略的时候进行一次转发
* 如果没有为变量设置允许历史存储策略，则变量每更新一次触发一次转发

## 新建转发通道

要配置数据的转发参数，需要先创建转发通信通道。目前DGather仅支持将数据转发到MQTT，后续版本将陆续开发MySQL、InfluxDB等其他类型数据库的转发驱动。

新建转发通道的流程如下：

1. 新建转发通道
请参照[新建通道](https://doc.bdgca.com/doc/10/)，通道驱动类型选择`MQTT-Publisher`。

2. 设置MQTT通信参数

![MQTT通信参数](/media/202406/2024-06-30_110606_0005250.4241056701297211.png "MQTT通信参数")

![MQTT通信参数](/media/202406/2024-06-30_111119_4874300.12671006880478697.png "MQTT通信参数")
## 变量转发配置

* 创建转发

![创建转发](/media/202406/2024-06-30_111641_1836990.7589685394798901.png "创建转发")

* 编辑转发

![编辑转发配置](/media/202406/2024-06-30_112005_4554950.4598310526085755.png "编辑转发配置")

![编辑转发配置](/media/202406/2024-06-30_112131_8279390.4281662921677265.png "编辑转发配置")

**转发配置说明**
>每个变量都有`名称`、`时间`、`数值`、`状态`四个基本属性字段，即变量基本信息选项卡中所显示的内容，这四个字段都是可以选择转发给接收端的。
![变量的基本属性](/media/202406/2024-06-30_120230_0874930.29062944055196216.png "变量的基本属性")

|项目|必选|默认值|说明
|----|----|----|----
|通信通道|是|---|通信通道由创建转发时候确定，编辑时不可更改
|格式|是|split|MQTT转发变量时，格式可选`json`或者`split`。选择`json`时，会将下方的`名称字段`、 `时间字段`、 `值字段`、 `状态字段`打包成一个`JSON`结构， 统一发送到给定的`主题`下。选择`split`格式时，`主题`将作为各字段的统一父主题，而`名称字段`、 `时间字段`、 `值字段`、 `状态字段`等将作为`主题`下的子主题。
|主题(Topic)|是|无|`格式`选择`json`时，`主题`是统一的；`格式`选择`split`时，此`主题`仅为父主题。
|名称字段|否|无|如果不填写，则变量的名称则不发布到MQTT
|时间字段|否|无|如果不填写，则变量的时间标签则不发布到MQTT
|值字段|否|无|如果不填写，则变量的数值则不发布到MQTT。一般情况下应至少设置发送值字段。
|状态字段|否|无|如果不填写，则变量的状态则不发布到MQTT
|质量码(Qos)|是|0|服务质量码，可选`0`、`1`、`2`，含义如下:{`0`:"订阅者至多接收一次(可能漏接收)",`1`:"订阅者至少接收一次(可能重复接收)"、`2`:"订阅者只接收一次"}
|保留(Retain)|是|false|MQTT服务器只会为每一个Topic(主题)保存最近收到的一条RETAIN(保留)标志位为true的消息！也就是说，如果MQTT服务器上已经为某个Topic保存了一条Retained消息，当客户端再次发布一条新的Retained消息，那么服务器上原来的那条消息会被覆盖！每当MQTT客户端连接到MQTT服务器并订阅了某个topic，如果该topic下有Retained消息，那么MQTT服务器会立即向客户端推送该条Retained消息。

* 转发配置结果

![转发配置结果](/media/202406/2024-06-30_115441_0873390.4944121481848791.png "转发配置结果")

![转发通道](/media/202406/2024-06-30_115738_2421280.36563033994610716.png)

# MQTT转发示例

## 以JSON形式转发变量

### JSON格式转发单个字段的示例
* 转发配置
将OPCDA-API驱动采集到的变量`numeric.saw.double`以JSON的形式转发到主题`topic/numeric/flow`。只转发一个`值字段`,并在设置中将`值字段`命名为`water_flow`。
![](/media/202406/2024-06-30_184641_3855120.9117413034447351.png)

* 转发结果
在MQTT客户端订阅主题`topic/numeric/flow`（该订阅没有通配符，意思为精确订阅），可以看到以json结构转发过来的数据：
![](/media/202406/2024-06-30_185028_6052220.41082865855365847.png)

### JSON格式转发多个字段的示例
* 转发配置
将Modbus-TCP采集的变量`modbus-sin`以JSON的形式转发到主题`topic/mbsin`。转发设置中没有配置`名称字段`的转发，只设置转发了`时间`、`值`和`状态`三个字段。
![转发配置示例](/media/202406/2024-06-30_181302_0113970.6096785606145682.png "转发配置示例")

* 转发结果
在MQTT客户端订阅`topic/mbsin`（该订阅没有通配符，意思为精确订阅），查看转发的结果，截图如下，收到了以JSON结构转发来的数据，包含`时间`、`值`和`状态`三个字段：
![转发结果示例](/media/202406/2024-06-30_181656_0725360.3718577900136426.png "转发结果示例")

## 以split形式转发变量
### 只转发一个字段的示例
* 转发配置
将OPCUA驱动采集到的`Temperature`变量转发到`topic/Temperature`主题下。设置以`split`的格式，只转发一个`值字段`,并将转发的`值字段`命名为`value`,配置截图如下：
![](/media/202406/2024-06-30_182327_0721190.7975798883359478.png)

* 转发结果
在MQTT客户端订阅`topic/Temperature/#`（主题最后含有`#`号通配符，意思为订阅该主题下的所有消息）。可以看到订阅接收到了主题为`topic/Temperature/value`的消息。
![](/media/202406/2024-06-30_182951_4224060.1359362012934957.png)

### 转发多个字段的示例
* 转发配置
将OPCDA-API驱动采集到的`numeric.saw.float`变量转发到`topic/mumeric/saw/float`主题下。设置以`split`的格式，转发`时间字段`和`值字段`,并将转发的`时间字段`命名为`Time`，`值字段`命名为`Value`,配置截图如下：
![](/media/202406/2024-06-30_183538_8641500.24523299224009965.png)

* 转发结果
在MQTT客户端订阅`topic/mumeric/saw/float/#`（主题最后含有`#`号通配符，意思为订阅该主题下的所有消息）。可以看到订阅接收到了主题为`topic/mumeric/saw/float/Time`和`topic/mumeric/saw/float/Value`的两个主题的消息。
![](/media/202406/2024-06-30_184007_6517140.3662370922492787.png)