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

发布版本：V7.7.0.202112

上线日期：2021年12月

补丁号：PT-146899

新特性介绍

• 扫描控件可以绑定基础资料字段
• 允许自定义查询方式，支持包含、等于、左包含
• 允许自定义查找到多个满足条件数据时的处理方式
• 允许查找不到满足条件数据时进行提示

特性效果展示

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

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

注意：

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

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

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

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

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

关联知识：应用示例

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

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

原帖路径：

https://vip.kingdee.com/article/12107?productLineId=1&isKnowledge=2