列表如何显示即时库存

1、上线日期：2021-3-11；

2、补丁号：PT146867（灰度版本），PT-146869（正式补丁，2021-3-25）。

一、列表显示即时库存字段原理：

1、即时库存是随出入库业务的发生而变化，列表查询即时库存，采用虚拟字段的方式，即：查询时动态获取，不保存在物理字段中；

2、列表加载时不自动获取库存，需要用户选择需要查询的物料明细范围，用按钮触发方式，避免出现性能问题；

二、以“出库申请单”为例，介绍BOSIDE配置过程说明：

1、列表是以创建虚拟字段方式实现，需要注册列表插件： “Kingdee.K3.SCM.Business.PlugIn. GetInvStockOperationForList”：

（1）标准产品中，存在库存单据已注册该插件，则该步骤可跳过；

（2）注册插件的方法参见社区帖子：关于列表获取库存-如何注册对应列表获取库存插件 https://vip.kingdee.com/link/s/MUj8t

（3）插件如图所示：

2、配置获取即时库存操作设置，如图所示：

3、系统预置了“获取库存”菜单按钮，只需要设置“是否可见”的属性即可，如图所示：

库存模块下的大部分单据和列表，已预置“获取库存”菜单按钮，如果单据没有预置的菜单按钮，则需要新建菜单按钮，并在“点击事件”中新增操作“获取即时库存操作”，如图所示：

三、BOSIDE配置完成后，在列表中可看到“获取库存”按钮，勾选需要查询库存的明细行记录，点击“获取库存”，系统会自动增加库存相关字段，如图所示：

四、扩展应用

1、如何同时显示辅单位的即时库存数量？

在BOSIDE中自定义数量类型的字段，字段名可不录，即：无对应的物理表字段，如图所示：

在获取即时库存操作配置界面中，“单据接收辅单位数量字段”选择自定义的字段，如图所示：

设置后的效果如图所示：

2、如何显示库存组织+物料+仓库的汇总即时库存？

在获取即时库存操作的配置界面，库存维度字段和单据匹配字段中，只设置需要汇总的库存维度映射关系，其他字段为空，单位相关字段的映射关系还是需要设置的，如图所示：

获取库存的结果如图所示：

五、注意事项：

1、获取即时库存操作与获取即时库存服务的配置界面几乎一模一样，由于列表获取即时库存是用虚拟字段实现，原有的获取即时库存服务不支持，因此新增了获取即时库存操作，获取即时库存操作支持表单操作和列表操作配置，获取即时库存服务如下图所示：

2、获取即时库存操作验证即时库存查看权限。

3、列表默认操作行限制为：2000，即：列表最多选择2000行明细记录获取即时库存。 可以通过sql语句调整一次最大获取库存行数，示例：

--调整默认获取库存最大行数 

UPDATE T_BAS_SYSTEMPROFILE SET FVALUE = '2000' WHERE FCATEGORY = 'STK' AND FORGID = 0 AND FACCOUNTBOOKID = 0 AND FKEY = 'MAXGETINVSTOCKROWS';

4、获取即时库存操作自动生成的虚拟字段，其名称、宽度、列显示位置根据配置返回字段信息来定，如果没有配置返回字段，则系统默认给定相关属性，如图所示：

5、不支持汇总行合计、过滤、引出、套打等需求，如需要满足这些需求，则需要二开物理字段的方式处理。

6、获取即时库存操作字段映射关系中，库存组织、物料必须设置；单位、基本单位必须设置，因为单据接收库存数量字段会按基本单位指定的字段和单位指定的字段之间的换算率进行转换；如果设置了单据接收辅单位数量字段，则辅单位、库存辅单位必须设置。

7、获取即时库存，会根据配置的字段映射，获取对应单据上非空维度的行过滤即时库存，返回合计的“库存返回数量字段”值，填充到对应单据接受字段上去。

8、对于调拨单、转换类单据、组装查询单，存在调拨前、调拨后、转换前、转换后、父项物料、子项物料等非单一库存维度，则需要配置多个菜单按钮，设置不同的字段映射关系。