You need to enable JavaScript to run this app. 如何通过Odoo xmlrpc外部API向res.partner模型上传带标签的文档?
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Odoo xmlrpc外部API向res.partner模型上传带标签的文档?

Odoo XML-RPC对接:res.partner关联文档上传与标签配置实现

提问背景

  • 开发Python应用,通过Odoo外部XML-RPC接口对接目标Odoo系统
  • 核心需求:向res.partner(联系人)模型上传多份关联的不同类型业务文档
  • 文档可见性要求:上传完成后,管理员可在「联系人模块→选中对应目标联系人→文档」标签页下查看所有上传内容
  • 附加要求:为每份上传的文档绑定指定业务标签
  • 当前卡点:检索数小时未找到适配该场景的XML-RPC调用方案,现有公开参考仅覆盖hr.employee模型附件上传、图片字段写入的实现逻辑,res.partner场景无直接可复用的调用示例,请求有相关落地经验的开发者提供可参考的实现方案

实现方案

Odoo 所有模块详情页展示的关联文档,本质都是ir.attachment模型的标准记录,通过通用外键机制和主业务模型关联,和hr.employee场景的附件上传底层逻辑完全一致,不存在res.partner专属的特殊调用规则,可按以下步骤完成开发:

核心调用流程

  • 定位目标联系人记录:通过res.partner模型的search方法,按业务筛选条件获取目标联系人的数据库主键ID
  • 处理文档内容:读取本地待上传文档的二进制流,完成Base64编码,作为附件内容的入参
  • 创建关联附件记录:调用ir.attachment模型的create方法,传入关联参数完成文档挂载,确保附件能在联系人详情页展示
  • 绑定业务标签:通过ir.attachment的多对多标签字段,关联提前预置的标签ID,完成文档分类

关键入参说明

创建ir.attachment时必须填写的核心字段:

  • name: 文档在Odoo界面的展示名称
  • res_model: 固定填写关联主模型的技术名称res.partner,字段值错误会导致附件无法在联系人文档页展示
  • res_id: 第一步获取的目标联系人主键ID
  • datas: Base64编码后的文档二进制内容,直接传原始字节会导致附件损坏
  • mimetype: 文档对应的标准MIME类型,用于Odoo前端正常预览文件
  • tag_ids: 多对多字段,使用Odoo标准的多对多写入语法传入关联的标签ID列表

参考实现代码

# 初始化XML-RPC公共连接(common/models对象的初始化逻辑略)
import base64

# 1. 获取目标联系人的记录ID
target_partner_id = models.execute_kw(
    db_name, user_uid, user_password,
    'res.partner', 'search',
    [[['ref', '=', '联系人业务编码']]]
)[0]

# 2. 读取本地待上传文档并编码
with open('合作协议扫描件.pdf', 'rb') as doc_file:
    encoded_doc = base64.b64encode(doc_file.read())

# 3. 获取目标标签的记录ID(标签不存在时可先调用ir.attachment.tag的create方法创建)
target_tag_id = models.execute_kw(
    db_name, user_uid, user_password,
    'ir.attachment.tag', 'search',
    [[['name', '=', '合作合同']]]
)[0]

# 4. 创建关联附件并绑定标签
models.execute_kw(
    db_name, user_uid, user_password,
    'ir.attachment', 'create',
    [{
        'name': '2024年度客户合作协议.pdf',
        'res_model': 'res.partner',
        'res_id': target_partner_id,
        'datas': encoded_doc,
        'mimetype': 'application/pdf',
        'tag_ids': [(6, 0, [target_tag_id])]
    }]
)

常见问题排查

  • 权限报错:需确保API使用的服务账号拥有res.partner读权限、ir.attachment创建权限、ir.attachment.tag的读权限
  • 附件不显示:检查res_model字段是否和目标模型技术名称完全一致,res_id是否为正确的联系人主键
  • 附件损坏无法打开:检查传入的datas字段是否为正确的Base64编码内容,未混入多余字符
  • 标签绑定失败:多对多字段需使用标准写入元组格式,不能直接传入标签名称或非标准格式的关联值

内容的提问来源于stack exchange,提问作者Macaret

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 07:36:03