BI报表

# BI报表简介
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230913195453.png" width="100%"/>

【BI报表】提供各种数据可视化的图表组件。用于将采集到的数据或历史数据以图表的形式展示出来，随时查看企业生产运营数据。但不具备指令下发能力。

看板均可以通过连接投屏到电视、平板、PC上查看。
开通云边协同功能后，可以在微信小程序中查看（详情请咨询支持人员）。

# 创建看板
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230913195538.png" width="100%"/>

点解右上角的【新建】按钮，即可创建看板。
# BI报表设置
 
## 数据源说明
通过“[数据机器人](http://doc.cloud-bird.com/doc/32/)”可以将采集到的数据发送给监控看板进行展示。

用例：
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714164121.png" width="60%"/>
如上图，从【倍福Ads读】节点，获取设备的数据。并将数据发送到【发送至监控看板】节点。

【发送至监控看板】节点设置：
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230714173702.png" width="100%"/>

- 【发送至监控看板】栏中，选择目标的看板
- 【数据标识】中，填写目标组件设置中的【数据标识】
以上两栏设置完毕后，则可以将【倍福Ads读】节点的数据，发送至“test”看板的“data_1”组件中进行展示。

## 图表组件说明
大屏看板中的图表组件，均为展示数据用，所以组件的使用方式都比较一致。不单各个组件独说明，以下为统一的说明：

组件的数据均有两种模式【静态数据】和【动态数据】
> 数据模式说明：
> - 【静态数据】此模式下数据为固定内容，主要是系统提供参考格式。
> - 【动态数据】此模式下可以接收从数据及机器人中传入的数据并进行展示。

### 静态数据
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722225600.png" width="90%"/>

数据从数据机器人中传入时（见【[数据源](#toBoard_simple_2)】说明），各个组件的所需要的格式略有不同，可以从“静态数据”中查看到（也可以通过修改静态数据进行数据格式调试）。

### 动态数据
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722231446.png" width="90%"/>

从数据机器人中，按照【[静态数据](#rest_data)】的格式传入后（见【[数据源](#toBoard_simple_2)】说明）。需要设置来源的JSON数据中，各个KEY对应图表中的字段。

### 【表格】组件
【表格】/【透视表格】组件的设置方式相对特殊，此处额外说明。
**步骤一**：我们需要在组件的【配置】中，设置表格的每列名称和每列的key（即“列id”）。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230723004739.png" width="90%"/>

**步骤二**：在【数据】中，动态数据的数据ID需要与步骤一种配置的列key（即“列id”）对应。既可以完成动态数据设置。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230723004908.png" width="90%"/>

用例：
比如当我们传入数据：
``` JSON
[{
 "sku": "苹果",
 "sales": "120"
 },
 {
 "sku": "香蕉",
 "sales": "200"
 }]
```
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722233030.png" width="40%">

在【柱状图】的图表组件设置中，将KEY“sku”指定为“X轴”，KEY"sales"指定为“柱状”。即会生成水果的销量柱状图。

## 表单组件说明
大屏看板中，提供【下拉框】和【时间筛选框】两个特殊组件，用于[下发](#send_data_simple)查询条件给[数据机器人](http://doc.cloud-bird.com/doc/32/)，进行筛选所需的数据。

### 【下拉框】组件
#### 下拉框选项
下拉框内容可以为【静态数据】，提供固定选项；也可以为【动态数据】从[数据机器人](http://doc.cloud-bird.com/doc/32/)中获取选项数据（见【[数据源](#toBoard_simple)】说明）。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722234149.png" hight="50%">
其中，下拉框中的数据区分为“标签”和“值”，标签用于展示，值用于回传给[数据机器人](http://doc.cloud-bird.com/doc/32/)。

#### 下拉框回传
同上述HMI中[下发](#send_data_simple)数据逻辑一致，通过设置【触发标识】和【数据栏位】，将下拉框中选中的选项的“值”，[下发](#send_data_simple)给[数据机器人](http://doc.cloud-bird.com/doc/32/)。再在数据机器人中进行使用（具体用法见【[用例](#drop_box_simple)】）。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722234709.png" width ="90%">

#### 联动触发
设置联动触发后，可以将其他下拉框或时间筛选框中的数据一起[下发](#send_data_simple)给[数据机器人](http://doc.cloud-bird.com/doc/32/)。
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230722234721.png" width ="90%">

#### 用例
看板中的配置：
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230723000436.png" width ="90%">
数据机器人中的配置：
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230723003531.png" width ="100%">

说明：
1、数据机器人中，第一行的作用为，通过【数据定义查询】组件，查询表中的数据。再通过【函数】组件，将数据中包含的【水果】类型筛选出来，作为下拉框中的可选项，发送给下拉框组件。
2、第二行的作用为，当看板中下拉框下发了数据到数据机器人，则以这个数据为查询条件，通过【数据定义查询】筛选相应的数据，再发送给监控看板。完成查询。

### 【时间筛选器】组件
使用逻辑跟【下拉框】组件基本一致。通过【时间筛选器】选择组件后，会将所选时间[下发](#send_data_simple)给[数据机器人](http://doc.cloud-bird.com/doc/32/)，数据机器人使用传来的数据作为查询条件进行查询处理（见【[用例](#drop_box_simple)】）。

# 看板分享
<img src="https://cloudbird-1305191050.cos.ap-guangzhou.myqcloud.com/20230723005511.png" width ="40%">

通过看板的“复制本地连接”操作，可以复制看板的连接。然后在同一网络下任何设备的浏览器上，都可以打开看板。