1. 功能与应用目标

模块功能定位：
扫码设置模块用于为指定设备配置扫码参数规则，包括扫码类型、触发模式、输出编码格式、输出方式、广播输出设置等。用户可按“机型”或“设备分组”维度创建扫码配置规则，以确保不同型号设备或场景下扫码功能的一致性和可靠性。

配置规则一旦下发至设备，设备将在系统中自动应用对应的扫码参数设置，确保扫码效率和数据解析的准确性。

扫码设置规则说明：

每个机型或分组仅允许配置一条扫码设置规则；
如选择“分组”作为应用维度，系统将在规则中展示该分组下所有支持的设备机型；
若分组中包含多个机型，系统会为每个机型设置独立的扫码参数；
若某设备机型在规则中无对应配置项，则不会下发扫码配置指令；
扫码配置规则一旦下发，将在设备端生效，生效后用户无法修改设备上“扫码设置”的配置参数；
删除扫码设置规则后，用户可以修改设备上“扫码设置”的配置参数。

主要操作：

添加扫码设置规则：支持按机型或设备分组配置扫码参数，设置完成后可一键下发；

次要操作：

编辑：支持修改已配置规则内容（不支持修改“适用范围”字段）；
删除：移除不再需要的扫码设置规则，并撤销下发至设备的配置指令。

典型应用场景：

门店存在不同扫码头设备，需配置不同的扫码参数以提高识别率；
配置扫码编码格式为 UTF-8，确保与 POS 系统对接数据一致；
禁用无效码制，避免扫码误识别；
控制扫码反馈行为（如声音/震动提示）以满足门店安静操作需求。

2. 主要操作

2.1 添加规则

操作说明

“添加规则”功能用于配置扫码参数，并将规则应用至特定机型或设备分组，使设备扫码行为符合业务需求。每条扫码规则仅支持应用于一个机型或设备分组，不可同时选择多个对象。

配置内容包括扫码头类型、触发模式、输出格式、广播参数、前缀/后缀字符处理、提示模式等。

支持按机型单独配置，也可对包含多个机型的分组统一配置规则，系统将依据设备类型自动分发配置指令。

操作流程

进入添加页面
- 点击规则列表页面右上角的【添加规则】按钮，打开扫码规则配置窗口。
选择适用对象
- 适用范围（必选）：选择“机型”或“分组”作为配置目标；
- 选择“机型”后，需指定具体设备型号，系统将展示该机型适配的扫码配置项；
- 选择“分组”后，系统将展示分组中各机型的配置 tab 页，支持逐一配置。
填写规则信息
- 规则名称（必填）：输入规则名称，用于标识该扫码规则；
- 根据目标机型或分组下各机型，配置扫码参数，主要包括：
  - 扫描头类型及支持的条码制式；
  - 扫描触发模式（自动、短按触发、长按停止等）；
  - 输出编码格式（UTF-8、GBK、ISO-8859-1、SHIFT-JIS）；
  - 输出方式设置（模拟串口/广播/无输出）；
  - 广播输出参数（广播名、键值名等）；
  - 去除字符（前/后缀处理）；
  - 提示模式（声音、震动）等。
保存并下发配置
- 完成配置后点击【保存】，系统将根据选择的适用对象进行规则创建并执行下发。
- 扫码配置规则一旦下发，将在设备端生效，生效后用户无法修改设备上“扫码设置”的配置参数；

注意事项

每条扫码设置规则仅可应用于一个“机型”或“分组”，不支持多对象绑定；
若选择“分组”作为适用范围，系统将仅对其中匹配已配置规则的机型设备下发配置；
分组中若存在未适配配置的机型设备，系统将自动跳过，不下发配置；
下发机制依据设备类型处理，具体如下：
- 若设备为 KMA 或 IMA 类型，且设备在线，配置将立即下发；
- 若设备为 KMA 类型且离线，系统将在设备上线后补发配置；
- 若设备为 IMA 类型，配置具有时效性，设备需在有效期内上线，超时将失效；
当前功能不适用于 GMA 设备类型，系统将自动忽略下发；
若配置内容填写有误或需调整，可通过“编辑”功能进行修改，系统将自动重新下发配置。

3. 次要操作

3.1 编辑

操作说明

“编辑”功能用于对已创建的扫码设置规则进行调整。用户可根据实际需要，修改扫码配置项并更新至目标设备，原有配置将被新配置替代。

系统不允许修改“适用范围”（即：机型 / 分组）字段，其余参数均可变更。规则保存后，系统将立即将更新后的配置下发至相关设备，并替换原规则。

操作流程

进入编辑页面
- 在扫码设置规则列表中，点击对应规则右侧的【编辑】按钮，打开规则编辑页面。
查看不可修改字段
- “适用范围”字段为只读状态，不可修改；
- 若适用范围为“机型”，则“设备型号”不可变更；
- 若适用范围为“分组”，则“分组名称”不可变更；
- 原有规则名称默认保留，可按需编辑。
修改配置参数
- 在配置区域，按照需要修改以下内容：
  - 扫码头类型及支持的条码制式；
  - 触发模式；
  - 输出编码格式；
  - 输出方式及连接控制；
  - 广播输出参数；
  - 去除字符设置；
  - 提示音/震动模式等。
保存配置
- 点击右下角【保存】按钮，系统将更新配置并执行下发，替换原配置内容。

注意事项

系统禁止修改“机型 / 分组”绑定关系，若需调整适用范围，建议删除原规则后重新添加；
编辑保存后，系统会将配置指令自动同步至关联设备，原规则配置将被替换；
下发机制与“添加规则”一致，具体如下：
- 若设备为 KMA 或 IMA 类型，且当前在线，配置指令立即下发；
- 若设备为 KMA 类型且当前不在线，配置将在设备上线后补发；
- 若设备为 IMA 类型，配置指令具有时效性，设备需在有效期内上线，超时将失效；
若分组中部分设备机型未适配配置参数，则该部分设备将不接受更新指令；
规则更新对设备端生效需等待设备与服务器通信完成同步，部分场景可能存在短暂延迟。

3.2 删除

操作说明

删除操作用于移除不再适用或已废弃的扫码设置规则。执行删除后，目标设备将不再受该规则约束，用户可在设备本地手动修改扫码设置配置参数。

系统将弹出二次确认窗口，避免误操作，确认后方可完成删除。

操作流程

发起删除操作
- 在扫码设置规则列表中，点击目标规则右侧的【删除】按钮。
确认提示
- 系统将弹出确认提示框：“确定要删除吗？”
- 点击【确定】，系统立即执行删除操作；
- 若点击【取消】，操作中止，不做更改。
完成删除
- 删除成功后，目标规则从列表中移除，系统不再下发或维护该配置内容。

注意事项

删除操作为不可逆行为，请谨慎执行；
删除规则后，设备本地不再强制执行扫码设置规则；
若设备无其他规则限制，用户可通过系统应用或本地设置修改扫码参数；
若需要恢复配置约束，需重新添加新的扫码设置规则；
若分组/机型中存在多个规则，仅删除指定项，其他规则不受影响。

4. 配置项说明

扫码设置模块涉及多种配置参数，用于细化设备扫码行为。本章节说明添加或编辑扫码规则时涉及的各项参数，帮助用户理解各配置项在设备端的实际作用。

配置项名称	是否必填	说明
规则名称	是	用户自定义规则名称，用于在规则列表中标识。建议命名规范、易于识别。
适用范围	是	设置规则应用对象，可选“机型”或“分组”。每条规则仅支持应用于一个对象，配置后不可修改。
设备型号 / 分组	是	若选择“机型”，需指定一个具体型号；若选择“分组”，系统将展示分组内所有支持扫码配置的设备机型并允许分别设置。
扫码头类型	是	设置设备使用的扫码引擎型号或厂商类型（如 Zebra、Honeywell 等）。系统会根据选择提供对应的参数项。
支持的条码制式	是	勾选当前设备支持识别的条码类型（如 Code128、EAN-13、QR Code 等）。多选。
触发模式	是	设置扫码的启动方式，包括： - 自动触发 - 短按触发 - 长按停止设备根据所设模式控制扫码操作行为。
输出编码格式	是	设置扫码结果的编码格式，用于确保与业务系统字符集一致。常见选项包括： - UTF-8（推荐） - GBK - ISO-8859-1 - SHIFT-JIS 等。
输出方式	是	设置扫码数据的输出方式： - 模拟串口：将扫码数据通过串口输出； - 广播：将扫码结果广播给指定应用接收； - 无输出：扫码后不输出，仅供测试或辅助。
广播参数	否	当输出方式选择“广播”时配置此项，包括广播名称、键值名称等。用于与业务应用通信。
去除字符设置	否	设置是否去除扫码结果中的前缀或后缀字符，常用于格式清洗。示例：去除二维码前的“http://”。
提示模式	否	设置扫码成功时的反馈方式： - 声音提示 - 震动提示可单选或多选，用于提升操作体验。

配置指令下发机制

设备类型将影响配置下发与生效方式，具体规则如下：

KMA 设备：
- 在线时：配置指令立即下发；
- 离线时：配置将在设备上线后自动补发；
IMA 设备：
- 配置指令具有有效期，超时未上线将视为失效；
GMA 设备：
- 不支持扫码设置，系统将自动忽略不执行。

配置生效行为说明

规则一旦创建并保存，系统将根据“适用范围”与设备类型自动下发配置；
设备成功接收配置后，将禁止用户在设备端修改扫码参数；
若执行“删除”操作，设备将解除扫码配置约束，用户可在本地自由配置扫码参数；
对于“分组”适用规则，系统将仅向该分组中已配置扫码参数的设备机型下发配置，未配置的设备将被忽略。