封装扫描控件，支持扫描设备场景下的快速录入数据需求。

企业经常会采用扫描设备进行快速录入，外部设备录入数据时会有统一传输数据的规则。为了更好的支撑该录入场景，封装一个专门的控件，可以绑定基础资料字段，实现外部扫描设备对接的快速录入。

发布版本：V7.7.0.202112

上线日期：2021年12月

补丁号：PT-146899

新特性介绍

特性效果展示

1、在BOS设计器的工具箱，可以拖拽扫描控件到单据头，绑定单据体的物料编码字段。

2、运行时，通过扫描设备向扫描控件传入值，系统匹配到满足要求的数据时，则会在目标字段单据体自动写入一行数据并填入基础资料字段值。（扫描设备在传入数据时会用回车换行符区隔数据）

注意：

a、手动模拟测试：可以在扫描控件中手动输入后键入回车键进行模拟测试。

b、只允许新增数据：为了保障持续录入不间断，该控件录入时不会读取单据体的光标，只允许新增数据，不支持选中某个单元格修改数据。

c、满足要求的数据：系统按照查询方式检索数据，如果匹配不到任一数据或满足要求的数据存在多条时，则默认会视作匹配录入失败。

若勾选参数“查询到多个满足条件的数据时手动选择”，则在满足该要求时弹窗让业务员手动选择（如下图所示）。

d、系统在匹配失败时，默认是不录入数据，如果希望失败时提醒，可勾选参数开启。

关联知识：应用示例

控件xtype为kdscantextext，服务端接收事件改用CustomEvent，

e.EventName为 Kingdee.BOS.KDScanTextChangedCustomEvent ，如下图：

原帖路径：