数据机器人

# 数据机器人
数据机器人为云雀数字机器人的核心模块，通过使用云雀提供的功能组件和工控协议，通过模块化的配置，即可以完成本系统与设备的连接、生产数据的采集计算、产线业务流程的数字化。
## 页面说明
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230713181526.png" width="100%">

区域说明
- 顶部tab：目前已经创建的引擎
- 左侧：组件目录，组件拖动出来后即形成节点
- 中间：数据流规则主区域
- 右侧：显示日志/异常操作
- 下方：打印的日志以及组件的异常提示
- 开启运行：开关开启后，当前引擎才会运行

## 创建引擎
在目录区域点击“加号”，即可创建一个新的引擎。各个引擎的数据之间互相独立。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714092031.png" width="50%">

## 业务节点
从左侧的组件库中，将需要的节点拖到中间的画板中。然后通过连线将各个节点连接起来，现成数据业务流程。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714100510.png" width="50%">
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714101740.png" width="80%">

### 节点详情
双击节点即可打开节点的详情界面。

#### 基础属性配置
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714110028.png" width="80%">

所有节点的基础属性配置都是一样的：
- 开启运行：默认开启，关闭后该节点以及后续节点都不会运行
- 节点类型：节点的类型
- 节点名称：默认等于节点类型，用户可修改
- 备注：节点的备注
- 节点输出： 节点输出的操作，节点输出支持三种方式： 
1、覆盖上一节点: 本节点的数据会直接覆盖上一节点的数据
2、合并数据： 当前节点的数据会和上一节点的数据进行合并，当要合并的数据为list，或者单一数据时(int值/字符串值等)，默认数据的key为value
3、挂在到$msg节点： 当前节点的数据会放在$msg节点下，挂载的变量由用户自定义
- 异常处理：当节点异常时，如何处理，目前支持二种方式：
1、终止流程： 终止当前节点以及后续流程
2、忽略异常并继续执行： 忽略当前异常并继续往下执行

#### 节点配置
各个节点的【节点配置】有所不同，具体请查看节点详情中的【帮助手册】tab。

### 数据流程规则
将节点连接起来后，每一个节点产生的数据通过【$msg.data_name】方式发送至下一个节点，下一个节点即可对获取都到数据进行处理。然后再发送至再下一个节点。

用例：
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714104902.png" width="80%">

如上图中，通过【Euromap63读】节点，读取到设备的状态数据后，会将数据发送至【判断】节点，根据设备的数据，判断是否需要报工，若是则报工。
或者是将读取到的设备状态数据，发送到【函数】组件，【函数】组件可以将数据进行清洗处理后，将处理的结果数据发送但【发送至监控看板】组件。

> 小tips：
>  可以通过【[日志打印](#log)】组件，来查看某个节点的输出的数据的具体值哦

### 表达式
数字机器人系统中，很多组件可以使用数据表达式，由用户以低代码的形式，自定义数据处理的算法。数据处理表达式使用JavaScript语言，无需编译，保存即生效。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714113349.png" width="80%">

表达式配置弹窗，左侧为云雀提供的已封装好的方法。双击可以使用。用户也可以在右侧的输入框中，编辑自己的函数体。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714113843.png" width="80%">
#### 自定义函数
云雀允许用户创建自己的函数库，将常用的方法封装起来，后续可以直接调用，避免重复编写。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714114242.png" width="35%">
第一步：输入函数的基础信息设置：函数名、所需参数等。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714114325.png" width="50%">
第二步：输入函数体内容。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714114604.png" width="60%">
第三步：确认保存后即可在函数列表中看到新创建的自定义函数。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714114658.png" width="35%">

## 手动执行
某些节点可以手动执行（比如【定时触发】【手动触发】），点击执行按钮则直接执行一次该节点。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714105309.png" width="70%">

## 节点运行状态
节点的下方，会显示当前节点的最后运行时间和运行次数
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714105524.png" width="80%">

## 节点异常状态
节点上发显示报警图标时，代表节点运行出现异常
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714105555.png" width="65%">

数据机器人下方将展示日志和异常：
- 日志：当某个节点与【日志打印】组件连接后，这里将展示这个节点输出的数据值。
- 异常：当某个节点发生异常时，这里将会自动显示异常。

# 运行日志
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714112350.png" width="100%">

组件【日志打印】节点，配置日志保存后，日志就会默认存储，该模块即可查看保存的日志。
**日志模块仅保存30天内的日志，超时日志会被自动删除**

# 异常日志
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714135012.png" width="100%">
当节点发生异常时，系统会自动记录。在该模块进行异常数据的追溯。
**日志模块仅保存30天内的日志，超时日志会被自动删除**

# 持久寄存器($dbs)
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714135237.png" width="100%">
数据机器人提供“持久寄存器”功能，用于存放全局变量。在数据机器人中，通过{$dbs.data_name}，即可以直接引用。

# 协议配置管理
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714140339.png" width="100%">
数据机器人中“工控协议”类的组件，需要进行连接字段配置。各个协议的配置内容有所不同，根据现场的实际情况即可。