数据机器人

# 数据机器人
数据机器人为羽刃OS的核心模块，通过使用羽刃OS提供的功能组件和工控协议，通过模块化的配置，即可以完成本系统与设备的连接、生产数据的采集计算、产线业务流程的数字化。
## 页面说明
<img src="/media/202401/WX20240125-140255_1706162586.png" width="100%">

区域说明：
- 顶部tab：目前已经创建的引擎
- 左侧：组件目录，组件拖动出到中间编辑区域后即形成引擎的“**业务节点**”
- 中间：数据流规则主区域
- 下方：调试日志以及组件的异常提示
- 开启运行：开关开启后，当前引擎才会运行

## 创建引擎
<img src="/media/202401/WX20240125-141748_1706163487.png" width="75%">

在目录区域点击“加号”，即可创建一个新的引擎。各个引擎的数据之间通常是互相独立的，可以通过【节点结束触发】或【节点异常触发】组件，监听其他引擎中的节点状态和指定节点的输出数据。

## 业务节点
<img src="/media/202401/WX20240125-142234_1706163771.png" width="80%">

从左侧的组件库中，将需要的节点拖到中间的画板中。然后通过连线将各个节点连接起来，现成数据业务流程。

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

#### 基础属性配置
<img src="/media/202401/WX20240125-142413_1706163864.png" width="80%">

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

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

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

用例：
<img src="/media/202401/WX20240125-142841_1706164134.png" width="70%">

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

> 小tips：
>  通过【数据流调试】组件，可以在页面下方的【[调试](#log)】栏中，查看某个节点的输出的数据的具体值，即可以快速判断输出数据是否符合预期。

### 表达式
羽刃OS系统中，很多组件可以使用数据表达式，由用户以低代码的形式，自定义数据处理的算法。数据处理表达式使用JavaScript语言，无需编译，保存即生效。
<img src="/media/202401/WX20240125-143117_1706164288.png" width="80%">

表达式配置弹窗，左侧为云雀提供的已封装好的方法。双击可以使用。用户也可以在右侧的输入框中，编辑自己的函数体。

#### 自定义方法
云雀允许用户创建自己的函数库，将常用的方法封装起来，后续可以直接调用，避免重复编写。

在【表达式】的编辑弹窗中，“新增方法”，打开自定义方法配置弹窗。

第一步，基本信息：定义函数的基础信息设置，如函数名、所需参数等。

第二步：输入函数体内容。

第三步：确认保存后即可在函数列表中看到新创建的自定义函数。

## 手动执行
某些节点可以手动执行（比如【定时触发】【手动触发】），点击【点击触发】按钮则直接执行一次该节点。
<img src="/media/202401/WX20240125-144332_1706165019.png" width="50%">

## 节点运行状态
节点的下方，会显示当前节点运行状态：

- 黄色字体，表示本节点的最后运行时间和运行次数
- 红色三角警示，表示本节点运行异常

数据机器人下方将展示调试和异常记录：
- 调试：当某个节点与【数据流调试】节点连接后，这里将展示这个节点输出的数据内容。用于调试输出是否符合预期。“调试”只会在浏览器处于当前页面是才会暂时记录，避免缓存溢出。
- 异常：当某个节点发生异常时，将会自动显示异常内容。

# 运行日志

当节点与【发送到运营日志】节点连接，即会在【运行日志】模块中，查看到这个节点的输出的数据内容。与【数据流调试】的区别为，【运行日志】节点不需要打开浏览器，都会自动保存。
**日志模块仅保存30天内的日志，超时日志会被自动删除**

# 异常日志
<img src="/media/202401/WX20240125-150318_1706166210.png" width="100%">

当节点发生异常时，系统会自动记录。在该模块进行异常数据的追溯。
**日志模块仅保存30天内的日志，超时日志会被自动删除**

# 持久寄存器($dbs)
<img src="/media/202401/WX20240125-150409_1706166259.png" width="100%">

数据机器人提供“持久寄存器”功能，用于存放全局变量。在数据机器人中，通过【$dbs.{data_name}】，即可以直接引用。

# 协议配置管理
<img src="/media/202401/WX20240125-150459_1706166308.png" width="100%">

数据机器人中“工控协议”类的组件，需要进行连接字段配置。各个协议的配置内容有所不同，根据现场的实际情况即可。