# 出入库报表

草料平台不支持自动计算功能，无法看到实时的库存数量。但可以使用外部数据分析工具-百度Sugar，连接草料官方数据库，自由实现各类计算，包括实时库存。

以下教程和示例，是以平台模板建码进行的。[查看出入库模板](https://cli.im/template/detail/30172739)

## 一、案例效果

可以输入物料名称，快速查询各物料的实时库存。[查看报表](https://sugar.aipage.com/report/r_1013e-boo7mgij-kejxgz/8b0d83bc802236bbcc12a545fa4f1cbd)

![库存管理界面，展示各品类低库存预警列表及出入库实时数据流水](https://blogcdnimg.clewm.net/2022/04/image-1650336539129_16503365397901.png)

### 使用前须知

由于涉及了基础的数据库（SQL）操作与BI工具操作。教程中会出现各类专业的名词，不要被这些吓到。使用中不需要你会程序，懂专业知识。只要你认真按教程进行操作就能完成。

## 二、开通官方数据库

可以在登录草料后，后台左侧`数据管理`–`数据API` ，选择`官方数据库`（[前往使用](https://user.cli.im/opendata "前往使用")）。

![草料二维码后台“数据管理”页的数据API开通入口，提供Webhook、官方数据库、自有数据库三种对接方式的开通选项](https://blogcdnimg.clewm.net/2024/04/image-1714370923533_17143709262509.png)

官方数据库申请成功后得到的数据库示例如下：

类型：MySQL 5.7
主机：rm-bp1m4fy8d66u3c6xmbo.mysql.rds.aliyuncs.com
端口：3306
数据库名：cli_13268724（示例）
用户名：cli_13268724（示例）
密码：ekiji17jd02jk9md（示例）

## 三、使用BI工具制作数据报表

这里推荐使用`百度Sugar`，上面示例也是使用百度Sugar制作的。原因是价格便宜（推荐基础版：价格480元/年，还有60/年的大屏尝鲜版）、数据实时更新，还提供1个月的试用。用户可以自行前往官方Sugar官网注册账号学习和使用。

百度sugar 官网：[https://cloud.baidu.com/product/sugar.html](https://cloud.baidu.com/product/sugar.html)

### 基本流程（以实时库存为例）

首先明确自己想要分析的目标，再去找对应的数据表。这里我们需要得到实时库存，就需要有原始库存，还有出入库数据。通过对出入库求和再加上原始库存就可以得到实时库数。 原始库存数是在批量数据表中有，出入库数据在出入库表单记录表中。

![该图展示报表制作的完整流程，含准备数据、制作报表与分享使用三大阶段及各阶段关键操作步骤](https://blogcdnimg.clewm.net/2022/04/image-1650336617547_16503366180086.png)

### 1. 准备数据

#### 1.1 连接数据库

选择类型：`Mysql 5.X`，填上来自草料官方数据的信息，添加即可。

![展示在“数据源”模块中添加MySQL数据源的配置界面，含类型选择、自定义名称及数据库连接信息填写区域](https://blogcdnimg.clewm.net/2022/04/image-1650357832734_16503578334032.png)

注意：数据源名称是自己命名的。

#### 1.2 创建数据模型

创建数据模型，从数据库中拖入需要的数据表。我们需要 `template_codeinfo_XXXXX`这个表（物料信息表），同时关联上`table_dXX`来获取各物料的出入库数据。[查看所有数据说明与常用数据模型](/help/integration-and-connection/data-api/official-database-guide)

**选择数据模型 — 拖入物品数据表**
这里需template_codeinfo_XXXXX这个，前面template_codeinfo都是一样，后缀数字各不相同的[查看批量数据表命名规则](/help/integration-and-connection/data-api/official-database-guide#46)

![数据源管理后台的“新建模型”页面，展示已创建的数据模型列表及编辑、分析等操作按钮](https://blogcdnimg.clewm.net/2022/04/image-1650355105009_16503551053412.png)

![Sugar BI 中数据表字段结构的浏览与编辑界面，展示“template_codeinfo_88041279”表的维度字段列表及操作选项](https://blogcdnimg.clewm.net/2022/04/image-1650355130578_16503551309058.png)

**拖入第二个数据表（出入库数据表）**
需要table_dXX这个表，前面table_D是相同的，后缀数字各不相同 [查看表单数据表命名规则](/help/integration-and-connection/data-api/official-database-guide#44)

设置表关联为左链接，条件是code_id（需要全部的物料信息）

![展示Sugar BI中“出入库示例”数据模型的左连接配置界面，说明如何通过code_id字段关联template_codeinfo与table_d73表](https://blogcdnimg.clewm.net/2024/01/image-1705456420392_17054564210535.png)

#### 1.3 整理数据

之前用户出问题较多的都在整理数据这个环节，请大家务必仔细阅读。

- 字段重命名
  我们的字段为了防重名，后面有数字后缀，重命名后方便后续使用。

![展示Sugar BI中编辑“入库数量”维度的配置界面，说明如何修改维度名称、物理字段名及所属表等属性](https://blogcdnimg.clewm.net/2022/04/image-1650359408710_16503594090166.png)

- 修改字段类型
  出入库字段默认识别为了字符串，无法进行求和试算，需转为数字。

![展示在Sugar BI中将数据字段“入库数量”从字符串类型转换为整数或小数类型的设置操作流程](https://blogcdnimg.clewm.net/2022/04/image-1650359437512_16503594378447.png)

- 转成度量
  出入库数量需要进行求和统计，需转成度量

!

[展示数据表字段的“转换为度量”操作流程，说明度量可放Y轴、维度放X轴的图表配置逻辑](https://blogcdnimg.clewm.net/2022/04/image-1650355345518_16503553458506.png)

将其它字段也同样设置好，主要是出库数量、入库数量、原始库存。

![该图展示Sugar BI中“出入库示例”数据模型的字段编辑与度量设置操作，重点说明编码名称需去数字后缀、库存/出库数量设为数字并转为度量](https://blogcdnimg.clewm.net/2022/04/image-1650359507627_16503595079832.png)

- 添加计算度量（实时库存）
  可以需要写计算公式，类似于Excel。公式为：`{原始库存量}-sum({出库数量})+sum({入库数量})`。注意这里都是英文的()。

![编辑计算度量的配置界面，展示公式输入区域、数据类型选择及SQL常用函数参考，用于自定义指标计算逻辑](https://blogcdnimg.clewm.net/2022/04/image-1650359600336_16503596006628.png)

- 添加筛选字段 （视自己情况）
  去掉些不需要的数据。比如表单中有审核功能，只能审核通过的才能算数，进行计算。就得去掉待审核、审核未通过的数据。

![该图展示数据筛选器操作流程：点击进入筛选器，新增条件后设置“状态=正常”的筛选项，用于过滤出表单中正常状态的数据记录](https://blogcdnimg.clewm.net/2022/04/image-1650359672043_16503596724001.png)

### 2. 制作报表

Sugar支持报表与大屏，这里介绍报表的创建方法，大屏也是同理的。

这者区别在于，大屏是一屏显示，各图表可以精细编辑，用于大屏展示；报表是上下浏览，内容更多，便于内部分享分析。

#### 2.1 创建报表

![弹窗界面用于新建报表，需填写名称、选择类型（如报表页面）、设置父目录及简介，并点击确认保存](https://blogcdnimg.clewm.net/2022/04/image-1650355655993_16503556566020.png)

#### 2.2 制作图表

选择`图表/表格`，这里我选择了表格，来展各物品的实时库存数。

![Sugar BI 报表配置界面，展示“选择表格”操作步骤及右侧控制面板的报表基础设置选项](https://blogcdnimg.clewm.net/2022/04/image-1650355680063_16503556806243.png)

**操作步骤**：

`选择数据模型` -> `拖入物料编号（唯一编号）和其它批量信息`

切记、切记、切记不要拖入出入库表单中的任何字段维度，比如记录时间、记录人等信息。拖入维度后，会按这些维度进行分类汇总，如果是记录时间，就会以单条记录来汇总，而我们是需要按物料编号进行汇总的。

![展示Sugar BI中“出入库管理”报表的字段拖拽配置界面，说明如何选择数据模型并拖入所需维度与度量字段](https://blogcdnimg.clewm.net/2022/04/image-1650355698787_16503556994287.png)

### 3. 报表美化与筛选项设置

**添加筛选组件**：

筛选组件可以帮我们查看指定数据的情况，是报表中常用的组件。

![展示Sugar BI中“出入库管理”报表的过滤条件设置界面，含单选/多选、日期时间等筛选方式及字段拖拽操作指引](https://blogcdnimg.clewm.net/2022/04/image-1650355740311_16503557409457.png)

添加数据模型，选择数据字段

![展示Sugar BI中“输入框”组件的筛选配置界面，重点说明如何通过“模糊匹配”等关联方式筛选数据字段](https://blogcdnimg.clewm.net/2022/04/image-1650355750610_16503557512355.png)

勾选关联的图表，系统会自动给你关联上引用过此字段的图表。

![展示Sugar BI中“出入库管理”模块的过滤查询与关联图表配置界面，支持按物料名称筛选并自动关联库存数据表](https://blogcdnimg.clewm.net/2022/04/image-1650355760056_16503557606694.png)

### 4. 分享使用

设置分享（发布）为`公开`，复制链接就可以去使用了。

![弹窗界面用于设置物料出入库管理的公开分享状态，支持选择分享类型与语言环境，并可更新状态](https://blogcdnimg.clewm.net/2022/04/image-1650356186208_16503561868385.png)

### 5. 链接到草料二维码

我们已与百度合作，支持在草料二维码小程序中，直接打开链接 Sugar报表。不会提示复制链接到浏览器中打开。 **操作方式**： 可以在批量模板插入跳转链接- 选择样式- 设置链接 - 选择外部链接 - 输入Suga报表链接。

![该图展示后台模板编辑中“导航链接”组件的样式选择流程，含免费/付费样式库、按钮样式预览及关联表单配置区域](https://blogcdnimg.clewm.net/2022/04/image-1650787963670_16507879642001.png)

![展示“物料清单”模板中添加外部链接的设置界面，重点为输入Sugar报表网址并切换至H5打开模式的操作步骤](https://blogcdnimg.clewm.net/2022/04/image-1650787987897_16507879884307.png)

## 四、学习交流

在实际操作过程中可能会遇到各类问题，可以 [前往草料社区](https://cli.im/community/minihome/question/104 "前往草料社区") 查看相关问题或提问，与数据报表大牛互助交流，草料官方顾问和技术也会定期查看并回复