使用YonBuilder进行简单的出入库管理

BIP91489

在日常的需求中我们可能会涉及到对于活动赠品的管理，在办活动之前需要采购一批赠品，并将其记录在库存表中，在活动结束之后要根据具体的需求申请相应的赠品数量，同时更新库存表。而这一种简单的出入库管理可以通过YonBuilder的业务流功能进行快速的实现。

需求	业务流功能
根据采购记录生成库存表	推单
根据库存表生成出库申请表	拉单
物品出库后更新库存数量	回写

1.创建应用

在YonBIP开发者社区中，点击导航菜单【学习资源】，下拉点击【YonBuilder开发体验】进入体验沙箱。点击左上角的四叶草图标，选择云平台中的应用构建服务，再选中构建平台的应用构建，即可进入到创建应用页面。

在应用管理页面点击新建应用新增一个名为出入库管理的应用，并进入应用开始编辑。

2.编辑应用

2.1 创建实体与页面

首先，根据我们的应用需求，我们要创建三个实体，分别对应采购单、库存单、以及出库申请单。

三个实体的引用接口统一勾选自动编码与业务流，其他实体信息记录在表格中，可以对照配置相关实体。

页面名称	实体名称	实体编码	字段编码	字段名称	字段类型
采购单	采购信息	order	item	物品名称	文本
			order_num	物品数量	整数
			order_name	采购人	文本
			order_date	采购日期	日期
库存单	库存信息	inventory	item	物品名称	文本
			num	库存数量	整数
			date	更新日期	日期
出库申请单	出库申请	apply	item	物品名称	文本
			num	库存数量	整数
			apply_num	申请出库数	整数
			apply_name	申请人	文本
			apply_date	申请日期	日期

要注意的是，页面建模时只能引用已发布的实体，因此在编辑好字段后需要选择保存并发布。在新建页面时元数据与页面名称的对应关系参照以上表格，三个实体对应生成了六个页面。

2.2 实现赠品入库

为了实现根据采购单更新库存的功能，需要配置推单业务流。在流程&自动化中进入业务流页面，新建一个名为入库的业务流，并进入设计页面。

首先将我们的采购单详情和库存单详情都拖到画布上，其次加入一条由采购至库存的推单规则，并将规则名称设置为入库。

触发设置这里为了简化操作流程选择为手工触发，在实际应用中可以将其设置为其他推送方式。转换规则按图中所示进行配置，将两个表单中的字段进行关联映射。

将现有设置进行保存，即完成了推单业务流的配置，接下来我们通过数据进行验证。在采购单页面新增了一条数据，并勾选数据进行下推，在库存页面刷新，可以看到一条流程名称为入库的数据与我们在采购订单中下推的数据相匹配，说明我们的推单业务流配置成功。

2.3 实现赠品出库以及回写库存

赠品出库需要使用业务流中的拉单功能进行实现，因此这里还需要根据库存数据新建一个单据类型为列表的生单页，将生单页的名称设置为拉库存表。

      

同时，我们要在出库申请页中加入业务流按钮，并将规则以及名称设置为拉单；在生单页中加入业务流按钮，将规则以及名称设置为生单

在页面修改完毕后进入业务流配置页面，新建一个名为出库的业务流并进入设计页面。将库存单详情和出库申请详情都拖到画布上，并加入一条由库存至出库申请的拉单规则，将规则名称设置为拉库存表。

在生单方式中将拉单页面勾选为拉库存表，并在转换规则中按图中所示进行配置。将现有配置进行保存，即完成了拉单业务流的配置。

考虑到在物品出库后需要更新库存表中的数量信息，因此这里还需要加入一条由出库申请至库存的回写规则，将规则名称设置为回写数量。

在回写规则的设置中，为了简化操作流程，这里将触发条件设置为单据进行保存动作，默认保存单据时即完成了出库行为。在回写规则中物品名称与ID都是简单映射，但是在物品数量上我们需要进行简单的公式计算，在公式中插入库存数量与申请出库数两个字段，并计算两个字段的差值，该差值即为需要回写的库存数量。

通过如上配置，我们已经实现了根据库存表生成出库申请单，并在物品出库后回写库存的过程，接下来通过数据进行验证。可以看到，通过拉单以及生单的方式成功拉取了库存数据并生成了出库申请单，在配置好申请出库数、申请人以及申请日期后保存单据，生成了一条出库申请单据，在库存页面刷新后物品数量以及更新日期均发生变化，且匹配我们设置的回写规则。这说明赠品出库以及回写库存功能已经配置成功。

综上，通过对实体、页面、业务流等进行配置，我们已经基本实现了基础的物品出入库管理功能。不过这篇文章主要目的是介绍业务流的入门用法，在实际业务中进行业务流的配置要考虑更多的因素，流程会更加复杂。

如果有任何疑问，欢迎在评论区交流探讨哦！