火一五欧度技能（Odoo 19）

辉火云企业套件（Odoo 19）接口访问完整指南 重要：公司系统使用 Odoo 19.0，必须使用 XML-RPC，odoorpc 库不兼容！

🏢 系统信息

账号规则

⚠️ 重要：必须使用 XML-RPC

Odoo 19 使用 XML-RPC，不支持 odoorpc 库！

正确方式（XML-RPC）

import xmlrpc.client

url = 'https://www.huo15.com'
db = 'huo15'

# 连接
common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common')
uid = common.authenticate(db, 'postmaster@huo15.com', '198809011ab', {})
models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object')

# 查询
result = models.execute_kw(db, uid, '198809011ab', 'res.partner', 'search_read', 
    [[('name', 'ilike', '关键词')]], 
    {'fields': ['id', 'name'], 'limit': 10})

错误方式（odoorpc）

# ❌ 不要使用 odoorpc 库，与 Odoo 19 不兼容！
from odoorpc import ODOO
odoo = ODOO('https://www.huo15.com', timeout=60)
odoo.login('huo15', 'postmaster@huo15.com', '198809011ab')

📋 Odoo 19 常用模型

联系人（res.partner）

项目（project.project）

任务（project.task）

🔧 常用操作示例

1. 登录并连接

import xmlrpc.client

url = 'https://www.huo15.com'
db = 'huo15'
user = 'postmaster@huo15.com'
password = '198809011ab'

common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common')
uid = common.authenticate(db, user, password, {})
models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object')

print(f"登录成功! UID: {uid}")

2. 查询客户

domain = [('name', 'ilike', '关键词')]
fields = ['id', 'name', 'vat', 'street', 'city', 'phone', 'email']
result = models.execute_kw(db, uid, password, 'res.partner', 'search_read', 
    [domain], {'fields': fields, 'limit': 10})

3. 创建客户公司

values = {
    'name': '公司名称',
    'company_type': 'company',  # 公司
    'vat': '统一社会信用代码',
    'street': '注册地址',
    'city': '城市',
}
partner_id = models.execute_kw(db, uid, password, 'res.partner', 'create', [values])

4. 创建联系人（关联到公司）

values = {
    'name': '联系人姓名',
    'parent_id': partner_id,  # 所属公司ID
    'type': 'contact',        # 联系人类型
    'function': '职位',
    'phone': '电话',
    'email': '邮箱',
}
contact_id = models.execute_kw(db, uid, password, 'res.partner', 'create', [values])

5. 查询项目

domain = [('active', '=', True)]
fields = ['id', 'name', 'partner_id', 'user_id']
result = models.execute_kw(db, uid, password, 'project.project', 'search_read',
    [domain], {'fields': fields, 'limit': 20})

6. 创建项目

values = {
    'name': '项目名称',
    'partner_id': partner_id,  # 客户ID
    'description': '项目描述',
}
project_id = models.execute_kw(db, uid, password, 'project.project', 'create', [values])

7. 查询任务（重要：必须加 active=True）

domain = [
    ('active', '=', True),  # ⚠️ 必须过滤开放任务
    ('project_id', '=', project_id),
]
fields = ['id', 'name', 'user_ids', 'stage_id', 'priority']
result = models.execute_kw(db, uid, password, 'project.task', 'search_read',
    [domain], {'fields': fields, 'limit': 50})

8. 创建任务

values = {
    'name': '任务名称',
    'project_id': project_id,
    'user_ids': [(6, 0, [user_id])],  # 负责人
    'description': '任务描述',
    'priority': '0',  # 0=普通, 1=紧急
}
task_id = models.execute_kw(db, uid, password, 'project.task', 'create', [values])

📊 execute_kw 参数说明

models.execute_kw(db, uid, password, model_name, method, args, kwargs)

⚠️ 注意事项

1. 必须使用 XML-RPC：Odoo 19 不兼容 odoorpc 库
2. 路径：/xmlrpc/2/common 和 /xmlrpc/2/object
3. 认证：使用 authenticate() 获取 uid
4. 任务查询：必须使用 ('active', '=', True) 过滤
5. 联系人类型：company=公司，contact=联系人
6. 关联字段：使用 ID 而非名称

📚 知识库 (Knowledge) 操作

核心模型

创建知识库文章

import xmlrpc.client

url = 'https://www.huo15.com'
db = 'huo15'
user = 'postmaster@huo15.com'
password = '198809011ab'

common = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/common')
uid = common.authenticate(db, user, password, {})
models = xmlrpc.client.ServerProxy(f'{url}/xmlrpc/2/object')

# 创建文章（body 使用 HTML 格式）
article_id = models.execute_kw(db, uid, password, 'knowledge.article', 'create', [{
    'name': '文章标题',
    'body': '<h1>文章内容</h1><p>这里是正文</p>',
    'internal_permission': 'write',
}])

重要字段说明

权限规则

⚠️ 常见错误

1. Invalid field 'article_type'：Odoo 19 没有这个字段，不要设置
2. 需要至少一个 writer：当 internal_permission='none' 时，必须添加 write 权限的成员

Markdown 转 HTML

def markdown_to_html(text):
    html = text.replace('\n\n', '</p><p>')
    return f'<p>{html}</p>'

🐳 Odoo Docker 本地开发

Docker 配置仓库

地址：https://cnb.cool/huo15/tools/odoo19_docker

本地路径：~/workspace/study/odoo_study/odoo19_docker

启动命令

cd ~/workspace/study/odoo_study/odoo19_docker
docker compose -p <项目名称> up --build

本地项目开发流程

1. 建立项目目录

~/workspace/projects/<公司>/
  └── <公司>_addons/      ← 项目 addons 源码

2. 创建软链接

ln -s ~/workspace/projects/<公司>/<公司>_addons \
       ~/workspace/study/odoo_study/odoo19_docker/<公司>_addons

3. 修改 docker-compose.yml

services:
  web:
    build: .
    volumes:
      - ./<公司>_addons:/usr/lib/python3/dist-packages/odoo/<公司>_addons

4. 重启项目

docker compose -p <项目名称> down && \
docker compose -p <项目名称> up --build

📂 Odoo 源码位置

🔗 相关技能

• huo15-doc-template：文档生成