允许通过简单场景管理条形码扫描仪
项目描述
库存扫描仪：扫描硬件的工作流引擎
本模块允许通过简单场景管理条形码扫描仪
可以为每个对象（库存拣选、库存、销售等）定义一个工作流
适用于所有扫描硬件型号（只需SSH客户端即可）
模块的“demo”目录中提供了一些演示/教程场景。这些场景在安装包含演示数据的数据库时自动导入。
安装
特定的ncurses客户端“sentinel.py”在“硬件”目录中可用。此应用程序是单独的客户端，可以在任何设备上运行。
对于移动设备，如Windows Mobile或Android智能条形码扫描仪，我们通常将其安装在服务器上，通过SSH访问。
如果您计划使用特定的“sentinel.py”，则需要“openobject-library”Python模块，可通过pip获取
$ sudo pip install “openobject-library<2”
为了测试该模块，一些模块提供了场景。
配置
在Odoo中
声明硬件
您必须在Odoo中声明一些硬件扫描仪。
转到“库存 > 配置 > 扫描仪配置 > 扫描仪硬件”并创建一个新记录。
“sentinel.py”客户端在启动时发送的“步骤类型代码”是硬件的IP地址，如果通过SSH连接。
如有必要，启用登录/注销
该模块包含用于登录和登出的2个预定义场景。该功能默认禁用，要在Odoo中使用，必须在sentinel使用的.oerp_sentinelrc文件中指定用户，并且可以在Odoo的硬件定义中覆盖。
如果启用了登录/登出功能，当用户使用sentinel开始会话时，屏幕上只显示登录场景。该场景将提示用户输入其登录名和密码。如果身份验证成功，与Odoo的每次交互都将使用连接用户的uid。一旦连接，将在可用场景列表中显示登出场景，而登录场景将不再出现。
登录/登出功能允许您在场景中指定有权访问场景的用户列表和/或组列表。
- 要启用登录/登出功能
转到“设置 > 仓库”并勾选“登录/登出场景启用”复选框。
创建一个名为“sentinel”的技术用户，无人力资源角色，并勾选“Sentinel: 技术用户”。
使用此用户启动您的sentinel会话。
请注意，Sentinel: 技术用户是一个技术角色，应仅由sentinel使用。
会话的超时由一个专门的cron管理，该cron会重置非活动会话。超时可以在设置中配置。“设置 > 仓库”
对于sentinel.py客户端
sentinel.py客户端需要一个标准的ini格式的配置文件，该文件不会自动创建。此文件可以命名为.oerp_sentinelrc，.openerp_sentinelrc或.odoo_sentinelrc，可以位于当前工作目录或用户的家目录。
配置文件中指定的用户由sentinel.py客户端用于连接到Odoo。可以通过设置用户字段来覆盖硬件，以执行具有定义用户的步骤，而无需为每个要连接的用户创建配置文件。
此文件仅包含服务器连接信息（主机名、端口、用户名、密码和数据库名）。
[openerp] 主机 = localhost 密码 = admin 数据库 = demo
请参阅hardware/odoo_sentinelrc.sample文件以获取示例。
注意：如果要将应用程序复制到git存储库之外，则需要复制i18n文件夹。
自动配置功能
sentinel.py客户端具有自动配置功能，用于自动识别连接的硬件。在初始化期间，sentinel.py客户端尝试检测SSH连接，并发送终端的IP地址作为终端代码。如果IP地址在数据库中配置的硬件的代码字段上找到，则将自动使用此硬件配置。如果未找到IP地址，客户端将要求用户输入（或扫描）代码。
这只能在Odoo服务器和连接的硬件位于同一网络时使用。
编写场景
创建
开始创建场景的首选方法是创建图视图中的步骤和转换。
创建步骤后，您可以直接从Odoo编写Python代码，或者可以将场景导出以使用您首选的代码编辑器编写Python代码。
- 每个步骤的Python代码中都有一些可用的变量
cr：数据库游标
uid：执行步骤的用户ID（用于通过sentinel登录的用户，或配置在硬件上的用户，如果有任何用户）
pool：数据库池器
env：用于执行场景的环境（新API）
model：场景配置的模型上的池器
custom：自定义值模型的池器
术语：当前场景中的记录集
上下文：步骤中使用的上下文
m 或 消息：硬件发送的最后一条消息
t 或 终端：在执行步骤的硬件上浏览记录
tracer：用于访问此步骤的使用的转换的tracer值
wkf 或 工作流：工作流服务
场景：硬件当前场景的记录集
_：Odoo提供的翻译函数（可在任何其他Python文件中使用）
其中一些变量也在转换条件执行中可用。
如前所述，步骤必须始终返回
步骤类型代码，在< cite>act变量中
要在硬件屏幕上显示的消息，在< cite>res变量中
可选，默认值，在< cite>val变量中
步骤类型
步骤类型主要由客户端管理。
标准步骤类型包括
M：简单消息
F：最终步骤，类似于M，但结束场景
T：文本输入
N：数字输入（整数）
Q：数量输入（浮点数）
L：列表
E：错误消息，类似于M，但以不同的颜色显示
C：确认输入
A：自动步骤。此类型用于自动执行下一步
导入
场景在模块更新时自动导入，就像任何其他数据一样。您只需在< cite>__openerp__.py文件中的< cite>data或< cite>demo部分添加您的< cite>Scenario_Name.scenario文件路径即可。
导出
导出脚本位于模块的< cite>script目录中
- 场景作为一组文件导出，包含
Scenario_Name.scenario：场景的全局描述（名称、仓库、步骤、转换等）
每个步骤一个.py文件：文件的名称是步骤的XML ID
使用测试文件
在开发场景时，您经常会运行相同的步骤。sentinel.py客户端允许您提供一个文件，该文件包含在场景期间按下的键。
您可以在配置文件中定义要使用的文件，在“test_file”键中。当场景等待用户输入（包括换行符）时，将读取此文件而不是调用curses方法。当文件已完全读取时，客户端退出。
可以在“步骤类型”演示场景中找到示例测试文件。
特殊键：对于特殊键（箭头、删除等），您必须编写一行包含“:”，后跟curses键代码。
- 有效的键代码是
KEY_DOWN：向下箭头
KEY_UP：向上箭头
KEY_LEFT：左箭头
KEY_RIGHT：右箭头
KEY_BACKSPACE：退格键
KEY_DC：删除
用法
在启动时，客户端列出可用的场景。当用户选择一个场景时，当前场景和步骤将存储在Odoo硬件配置条目中。
当客户端向服务器发送消息时，根据当前步骤和发送的消息选择下一个步骤。然后，服务器返回步骤的结果，其中包含其类型代码和在硬件屏幕上显示的文本。与标准Odoo工作流不同，每个步骤都需要找到有效的转换，因为步骤需要始终在硬件屏幕上显示。
为Datalogic PowerScan扫描仪开发的客户端是为该模块的早期版本开发的。相关文件已被删除，但仍然可以在git仓库历史中找到。
问题跟踪器
问题在GitHub问题上进行跟踪。如有问题，请先检查是否已报告过您的问题。如果是首次发现，请帮助我们通过提供详细且受欢迎的反馈来解决问题。
致谢
图片
Odoo社区协会：图标。
贡献者
Alexandre Fayolle <afayolle.ml@free.fr>
Christophe CHAUVET <christophe.chauvet@syleam.fr>
Damien Crier <damien@crier.me>
Laetitia Gangloff <laetitia.gangloff@acsone.eu>
Laurent Mignon <laurent.mignon@acsone.eu>
Olivier Dony <odo@openerp.com>
Sebastien LANGE <sebastien.lange@syleam.fr>
Sylvain Garancher <sylvain.garancher@syleam.fr>
维护者
本模块由OCA维护。
OCA，或Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并推广其广泛使用。
要为此模块做出贡献，请访问https://odoo-community.org。
散列值 for odoo10_addon_stock_scanner-10.0.1.1.2-py2-none-any.whl
| 算法 | 散列摘要 | |
|---|---|---|
| SHA256 | b2f0c4af9d45bbab790d9caba3b2398d9fb42f45002ecdca0103ec088462110d |
|
| MD5 | f0ac4c389fa60e38111b92cfdb1bb841 |
|
| BLAKE2b-256 | 97f40ae4e7240d8f0fec945e4026662d9d771b8d63f4bb614740ceab6ae8904a |