企业 ERP 数据全生命周期管理

通过官方 XML-RPC 接口管理 Odoo 企业数据，支持动态多实例切换、通用 CRUD 操作及模型结构探查，适合跨环境 ERP 集成场景。

基本信息

• 技能名称?Odoo Manager
• 中文名称?企业 ERP 数据全生命周期管理
• 作者?willykinfoussia
• 分类?专业技能
• 版本?0.0.1
• 标签?odoo, erp, xml-rpc, crud, multi-tenant, business-data, api-integration, enterprise

使用方法

使用说明
核心用法
Odoo Manager 通过官方 External XML-RPC API 与 Odoo 实例通信，提供三层动态连接解析机制（temporary/user/environment），支持密码或 API Key 双认证模式。核心操作围绕 execute_kw 方法展开，覆盖任意模型的完整 CRUD 生命周期：
查询层 ： search / search_count / search_read 支持分页、过滤域（domain）与字段裁剪
数据层 ： read 单条/ create 创建/ write 更新/ unlink 删除
探查层 ： fields_get 获取字段元数据、 ir.model 列举可用模型、 name_search 模糊匹配
预设 res.partner （联系人/公司）快捷流，开箱即用；同时通过 ir.model.fields 支持任意自定义模型的动态 introspection。
显著优点

1. 多环境无缝切换 ： temporary_ 单次覆盖 + user_ 会话持久 + 环境变量兜底，无需重启即可在 production/staging/客户实例间跳转
2. 零模型限制 ：所有操作通过通用 execute_kw 执行，不限于预设模型，适配高度定制化的 Odoo 部署
3. 企业级认证兼容 ：同时支持传统密码与 Odoo 16+ 推荐的 API Key 机制，后者可细粒度控制权限并支持审计
4. 官方协议背书 ：基于 Odoo 官方文档实现的 XML-RPC 调用，非逆向或私有接口，升级兼容性有保障
   潜在局限
   协议老旧 ：XML-RPC 相较于 REST/GraphQL Payload 冗余、调试困难，大批量数据传输效率偏低
   并发与事务 ：单次调用即独立事务，无原生批量事务或连接池管理，高频写入需客户端自行限流
   权限黑洞 ：Odoo 的 ACL/Record Rule 错误仅返回模糊异常，技能层无法区分"记录不存在"与"无权限查看"
   字段类型复杂性 ：One2many/Many2many 的 command list 协议（ (0, 0, {}) / (2, id) 等）未在文档中详述，复杂关联写入需查阅 Odoo 官方文档
   适合人群
   ERP 实施顾问 ：需要跨客户实例快速验证数据或批量修复
   内部系统集成开发者 ：将 Odoo 作为主数据源的中间件/ETL 流程
   多租户 SaaS 运维 ：同时监控多个 Odoo 实例健康度与数据一致性
   常规风险
   凭证泄露 ： ODOO_PASSWORD / ODOO_API_KEY 为高敏感信息，若日志未脱敏或环境变量被意外打印，将导致全数据库访问权限外流
   误操作不可逆 ： unlink 为物理删除，非 Odoo 前端默认的 archive；批量删除无回收站保护
   上下文残留 ： user_* 会话级变量若未主动清除，可能导致后续操作意外落入错误环境
   网络中间人 ：XML-RPC 默认无 TLS 强制校验，自托管实例若证书配置不当存在窃听风险
   配置建议
   生产环境强制启用 API Key 并分配最小权限专用账号
   敏感操作前执行 version() + search_count 双重确认，避免域过滤条件错误导致全表扫描
   批量任务设置合理 limit （建议 ≤200）与指数退避重试
   odoo erp xml-rpc crud multi-tenant business-data api-integration enterprise