Barcode device troubleshooting¶
Odoo 条形码 支持三种主要类型的条形码扫描仪：USB 扫描仪、蓝牙扫描仪和移动电脑扫描仪。在配置每种类型的扫描仪时，可能会出现一些常见问题，即扫描仪无法按预期工作，Odoo 会向设备返回错误信息。
请阅读以下部分，以确定与特定常用扫描仪类型有关的一般和特殊设备问题。
一般问题¶
有关常用条形码扫描仪设备的常见问题，请参阅以下章节。
有关特定设备的问题，请参阅移动计算机扫描仪的 Android 扫描仪 部分，或 USB 和蓝牙扫描仪的 Screenless 扫描仪 部分。
无法读取条形码¶
使用条形码扫描仪时遇到的一个常见问题是无法读取条形码而导致错误。
出现这种情况的原因可能有以下几种：
条形码已损坏。
设备无法读取所需的条形码类型（某些扫描仪只能读取二维条形码）。
扫描的条形码显示在屏幕上。有些扫描仪不支持这种方式，必须将条形码打印出来才能扫描。这种情况在一维条形码中最为常见。
设备没有电池或已损坏。要排除这种情况，请按照以下章节中的故障排除说明进行操作。
Odoo 返回条形码错误¶
所有类型的条形码扫描仪都有自己的设备 “语言”，这会影响它们向 Odoo 的 条形码 应用程序输出条形码数据的方式。有时，这会导致 Odoo 条形码 在扫描后返回条形码错误。这可能是由于以下原因造成的：
计算机配置的键盘布局与条形码扫描仪不同。要排除这种情况，请确保设备配置了相同的键盘布局。
例如，如果计算机配置为使用 FR-BE 键盘，则应配置扫描仪发送 FR-BE 按键。如果使用的是平板电脑而不是电脑，也适用同样的逻辑。
有关配置按键的更多信息，请参阅 条形码扫描仪设置 说明文档。
对于移动计算机扫描仪（例如 Zebra 设备），扫描仪对条形码的解释可能与预期不同。要排除这种情况，请扫描测试条形码，看看扫描仪是如何解释条形码的。
安卓扫描仪¶
使用安卓和 Google 浏览器的最新型条码扫描仪应能与 Odoo 兼容。不过，由于型号和配置的多样性，建议首先测试扫描仪与 Odoo 的兼容性。
推荐使用 Zebra 产品系列，特别是 Zebra TC21（仅 WiFi） 和 Zebra TC26（WiFi/蜂窝）。
条形码应用程序不提供反馈¶
默认情况下，安卓条码扫描仪会对条码进行预处理，然后发送全文。由于 Odoo 条形码 无法读取此类输出，因此必须正确配置每种扫描仪的设置。
Odoo 条形码 希望扫描仪像模拟键盘一样工作，因此只检测*按键事件*。有关最常用设备的配置设置，请参阅以下章节。
Zebra TC21/TC26¶
使用 Zebra 扫描仪时，请确保设置了以下按键配置，以防出错。
从 Zebra 扫描仪的主屏幕开始，选择 DataWedge 应用程序（应用程序由 （浅蓝色条形码） 图标表示）。
在 DataWedge 简介 页面上，选择配置文件选项以访问 Zebra 扫描仪的设置。
选择配置文件后，向下滚动到 键盘输出 选项，确保 启用/禁用按键输出 选项为 已启用。
启用该选项后，回到 简介 选项页面，进入 按键输出 部分。然后，打开 主要活动选项 子菜单。在 字符 下，确保选中 将字符作为活动发送 选项。
重要
必须在 Zebra 扫描仪上选中 将字符作为活动发送 选项，否则 Odoo **无法**识别扫描的条形码。
采取上述步骤后，请执行测试扫描，以确保 Zebra 扫描仪正常工作。
MUNBYN 安卓设备¶
使用 MUNBYN Android 扫描仪时，请确保设置了以下配置以防出错。
从设备的主屏幕，点击 。在出现的页面中，找到 处理模式 部分，然后选择 键盘输入。
小技巧
所选的 处理模式 控制条形码数据读出后的数据处理方式。
键盘输入 在光标位置输入读出数据，与模拟键盘上的输入数据相同。
完成上述步骤后，执行测试扫描以确保 MUNBYN 安卓扫描仪正常工作。
为什么扫描成功后应用程序中没有数据输出？
扫描条形码时，扫描仪可能会发出提示音，表示扫描成功，但应用程序中没有数据输出。
要解决这个问题，请在设备上的*扫描仪*应用中将输出方式调整为*键盘模拟*。
从设备的主屏幕，点击 页面，点击 输出模式。弹出窗口将显示用户可用的不同输出选项。选择 键盘模式，然后点击 确定。
返回需要扫描的应用程序，在扫描前首先点击输入对话框。最后，执行一次测试扫描，确保 MUNBYN Android 扫描仪正常工作。
Datalogic Android 设备¶
使用 Datalogic Android 扫描仪时，请确保设置了以下配置以防出错。
要查看和配置扫描仪的所有设置，请使用 Datalogic Android 设备上的 设置 应用程序。从应用程序菜单中选择 。
From the resulting list of settings, select Wedge. From this menu, under the Keyboard wedge section, ensure that the Enable keyboard wedge feature is activated.
Then, also under the Keyboard wedge section, locate the Keyboard wedge input mode option. By default, the input mode is set to Text injection.
Click Keyboard wedge input mode, and change the setting to Key pressure. This ensures that scanned barcodes are translated into keyboard strokes, instead of being injected into the text area.
Once all those steps have been taken, perform a test scan to ensure the Datalogic Android scanner is working as intended.
Screenless scanners¶
Screenless scanners are barcode scanning devices that have no screens. These include USB scanners and bluetooth scanners.
重要
Odoo 支持大多数 USB 和蓝牙条形码扫描仪，因为它们都模拟键盘。不过，若要验证扫描仪是否与特定键盘布局兼容（或可配置为兼容），请参阅 Odoo 的 `库存与条形码兼容硬件 <https://www.odoo.com/app/inventory-hardware>`_文档。
NETUM 设备¶
默认情况下，NETUM 条形码扫描仪的用户手册仅显示法语键盘配置。要使用比利时键盘，请扫描以下代码：
Once that code has been scanned, ensure the NETUM scanner has the correct keyboard configuration, and is working as intended.