允许通过简单场景管理条形码读取器
项目描述
库存扫描器：扫描硬件的工作流引擎
本模块允许通过简单场景管理条形码读取器
您可以定义每个对象（库存拣选、库存、销售等）的工作流
与所有扫描硬件型号兼容（只需SSH客户端）
在模块的“demo”目录中有一些演示/教程场景。这些场景在安装带有演示数据的新的数据库时自动导入。
安装
“sentinel.py”特定的ncurses客户端位于“硬件”目录中。此应用程序是独立的客户端，可以在任何设备上运行。
对于移动设备，如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的扫描仪硬件定义中覆盖。
如果启用了登录/注销功能，当用户使用哨兵启动会话时，屏幕上只会显示登录场景。该场景会提示用户输入其登录名和密码。如果认证成功，与Odoo的每次交互都将使用连接用户的uid进行。一旦连接，注销场景将在可用的场景列表中显示，而登录场景将不再出现。
登录/注销功能允许您在场景中指定具有场景访问权限的用户列表和/或组列表。
- 要启用登录/注销功能
转到“设置 > 仓库”并勾选“登录/注销场景启用”复选框。
创建一个没有人力资源角色的技术用户‘哨兵’，并勾选“哨兵：技术用户”。
使用此用户启动您的哨兵会话。
请注意，哨兵：技术用户角色是一个技术角色，应仅由哨兵使用。
会话的超时由一个专门的cron管理，用于重置非活动会话。超时可以在设置中配置。“设置 > 仓库”
对于sentinel.py客户端
sentinel.py客户端需要一个标准ini格式的配置文件，该文件不会自动创建。此文件可以命名为.oerp_sentinelrc、.openerp_sentinelrc或.odoo_sentinelrc，可以位于当前工作目录或用户的家目录中。
配置文件中指定的用户由sentinel.py客户端用于连接到Odoo。可以通过设置User字段来覆盖硬件，以执行具有定义用户定义的步骤，而无需为每个需要连接的用户创建配置文件。
此文件仅包含服务器连接信息（主机名、端口、用户名、密码和数据库）。
[openerp] host = localhost password = admin database = demo
请参阅hardware/odoo_sentinelrc.sample文件以获取示例。
注意：如果您想将应用程序复制到git存储库之外，您还需要复制i18n文件夹。
自动配置功能
sentinel.py客户端具有自动配置功能，用于自动识别连接的硬件。在初始化期间，sentinel.py客户端会尝试检测SSH连接，并发送终端的IP地址作为终端代码。如果在数据库中配置的硬件的< cite>code字段上找到IP地址，将自动使用此硬件配置。如果未找到IP地址，客户端将要求用户输入（或扫描）代码。
这只能在Odoo服务器和连接的硬件位于同一网络时使用。
编写场景
创建
开始创建场景的首选方法是创建图视图中的步骤和转换。
创建步骤后，您可以直接从Odoo编写Python代码，或者可以将场景导出以使用您首选的代码编辑器编写Python代码。
- 在各个步骤的Python代码中，一些变量是可用的
cr : 数据库游标
uid : 执行步骤的用户ID（使用哨兵登录的用户，或配置在硬件上的用户，如果有的话）
pool : 数据库池器
env : 用于执行场景的环境（新API）
model : 场景配置的模型上的池器
custom : 自定义值模型上的池器
term : 当前场景上的记录集
context : 步骤使用的上下文
m 或 message : 硬件发送的最后一条消息
t 或 terminal : 执行步骤的硬件上的浏览记录
tracer：用于访问此步骤的使用的转换跟踪器的值
wkf或工作流：工作流服务
场景：当前场景的硬件记录集
_：Odoo提供的翻译函数（可用于任何Python文件中）
其中一些变量在转换条件执行时也可用。
如前所述，步骤必须始终返回
步骤类型代码，在act变量中
显示在硬件屏幕上的消息，在res变量中
可选，默认值，在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 odoo9_addon_stock_scanner-9.0.1.0.0-py2-none-any.whl
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 83dc2fbd957b696c94c0a36bb0d64079ae191505ca0030864e91642736d8b6bc |
|
| MD5 | b89b855e0f484dd4827d1300e60b6cb3 |
|
| BLAKE2b-256 | 82c82a3678d7385347ddd949a3731e3c95babefba89c4bed1d2305bbc49a3884 |
