如何通过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: 第一步获取的目标联系人主键IDdatas: 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
相关产品推荐
相关产品推荐

