如何在 Odoo 19 中创建序列号

在 Odoo 19 中，序列号对于为各模型的记录提供唯一标识符至关重要。这些标识符可遵循自定义格式（如前缀或填充位数），便于有条理的跟踪记录。序列号在 Odoo 应用中应用广泛，例如发票、订单、产品等场景。

本文将介绍两种创建自定义序列号的方法：一种是通过代码为特定模型定义序列号，另一种是使用 Odoo 内置的设置界面创建。为便于演示，我们将创建一个新的 “图书馆管理” 模块，为图书馆中的每本书分配唯一的参考编号。

一、为什么使用序列号？

使用序列号可确保每条记录都有唯一的标识符，这对于在业务流程中保持清晰性、一致性和可追溯性至关重要。通过为发票、订单或产品分配序列号，企业能够简化记录管理、减少重复项，并加强对交易的管控。这种做法有助于准确跟踪和检索信息、提高报表精度，并实现与其他系统的无缝集成，确保跨平台数据完整性。此外，序列号还能通过提供清晰的审计轨迹支持合规性，预防错误，并便于发现差异或欺诈行为。

二、使用序列号的好处

• 唯一性：确保每条记录都能被明确识别。
• 可追溯性：便于在记录的整个生命周期内对其进行跟踪。
• 可定制性：允许企业定义符合自身品牌和运营需求的格式。

三、方法一：通过代码创建序列号

步骤 1：定义模型

首先，创建需要应用序列号的模型。此处我们将创建一个 library.book 模型（代表图书馆中的书籍），并配置序列号以生成唯一的参考编号。

from odoo import fields, models, api, _

class LibraryBook(models.Model):
    _name = 'library.book'  # 模型名称
    _description = 'Library Book'  # 模型描述

    name = fields.Char(string="书名", required=True, help="书名")
    author = fields.Char(string="作者", required=True, help='书的作者')
    isbn = fields.Char(string="ISBN", required=True, help="书的ISBN")
    reference_number = fields.Char(string="参考编号", default=lambda self: _('New'), readonly=True, copy=False, help="书的参考编号")

    @api.model_create_multi
    def create(self, vals_list):
        """批量创建书籍时，为每条记录自动生成参考编号"""
        # 遍历vals_list（列表），处理每条记录的vals（字典）
        for vals in vals_list:
            # 若reference_number字段值为默认的“New”，则生成序列号
            if vals.get('reference_number', _('New')) == _('New'):
                vals['reference_number'] = self.env['ir.sequence'].next_by_code('library.book') or _('New')
                # 调用父类的create方法完成记录创建
        return super().create(vals_list)

代码解释：

• reference_number：字符类型字段，默认值为 “New”，用于存储每本书的唯一标识符。
• create：重写模型的创建（create）方法，在每次创建新记录时，为 reference_number 字段分配由序列号生成的标识符。

步骤 2：在 XML 中定义序列

模型配置完成后，需为 library.book 模型定义序列号。可在模块的 data 目录下创建一个 XML 文件来实现。

创建名为 ir_sequence_data.xml 的 XML 文件。

<?xml version="1.0" encoding="UTF-8" ?>
<odoo>
    <data noupdate="1">  <!-- noupdate="1"表示该记录创建后不被模块更新覆盖 -->
        <record id="ir_sequence_library_book" model="ir.sequence">
            <field name="name">图书馆书籍参考编号</field>  <!-- 序列号的描述性名称 -->
            <field name="code">library.book</field>  <!-- 与模型关联的标识代码 -->
            <field name="prefix">LIB</field>  <!-- 参考编号的前缀（如“LIB”代表“图书馆”） -->
            <field name="padding">5</field>  <!-- 序列号的数字部分填充位数（如5位则显示为00001） -->
            <field name="number_next">1</field>  <!-- 序列号的起始编号 -->
            <field name="number_increment">1</field>  <!-- 序列号的递增步长 -->
            <field name="company_id" eval="False"/>  <!-- 不绑定特定公司（全公司通用） -->
        </record>
    </data>
</odoo>

XML 字段说明：

• id：序列号记录的唯一标识。
• name：序列号的描述性名称（如 “图书馆书籍参考编号”）。
• code：将序列号与 library.book 模型关联的关键代码。
• prefix：参考编号的前缀（如 “LIB”）。
• padding：序列号数字部分的填充位数（如 5 位则生成 “00001”，“00002” 等）。
• number_next：序列号的起始数字。
• number_increment：序列号每次递增的步长（通常为 1）。
• company_id：设置为 False 表示该序列号适用于所有公司，若需绑定特定公司，可指定公司 ID。

步骤 3：测试序列生成

完成模型和序列号的定义后，导航至 library.book 模型（可能需要在模块中为该模型创建菜单）。创建新书籍记录时，填写标题、作者和 ISBN 字段，提交后会发现 “参考编号” 字段已自动填充为唯一标识符，格式如 LIB00001、LIB00002 等。

四、方法二：通过 Odoo 设置菜单创建序列号

若不希望直接编写代码，也可通过 Odoo 界面创建序列号。这种方法适合非技术用户，便于为不同模型管理或创建序列号。

步骤 1：访问序列菜单

进入 Odoo 后台的"设置"。在"技术"下，找到"序列Sequences"，然后选择"序列"。

步骤 2：创建新序列

点击"创建"打开一个新的序列号表单，填写以下字段：

• 名称（Name）：序列号的描述性名称，如 “图书馆书籍参考编号”。
• 代码（Code）：设置为与模型对应的代码，例如 library.book。
• 前缀（Prefix）：添加前缀（如 “LIB” 代表图书馆）。
• 填充位数（Padding）：输入数字部分的位数（如 5）。
• 下一个编号（Number Next）：设置序列号的起始数字。
• 编号增量（Number Increment）：定义序列号的递增步长（通常为 1）。

步骤 3：保存并应用

填写完必填字段后，保存序列号配置。此后，每当在 library.book 模型中创建新记录时，Odoo 都会自动应用该序列号，生成唯一标识符。

五、序列号的额外自定义选项

Odoo 序列号提供多种自定义选项，可根据具体需求调整。

1. 为序列号添加日期范围

可将序列号配置为特定日期范围（如每年或每月重置），该功能特别适用于需要按周期跟踪记录的模型（如发票、合同）。

配置方法：在序列号表单中勾选 “按日期范围使用子序列”（Use subsequences per date range）选项，然后在 “日期范围”（Date Range）字段中设置所需周期（如 “月度” 或 “年度”）。

2. 标准模式与无间隔模式（Standard vs. No Gap）

Odoo 允许序列号使用 “标准模式”（Standard）或 “无间隔模式”（No Gap）：

• 标准模式（Standard）：若序列号被跳过或记录被删除，编号会继续向下一个可用数字递增，可能存在间隔。此模式通常用于会计场景（每个编号对应唯一凭证）。
• 无间隔模式（No Gap）：会自动填补缺失的编号，确保序列连续。此模式常用于运营跟踪（缺失标识符可能导致混淆）。

六、总结

在 Odoo 19 中，创建自定义序列号可显著提升各模块的记录管理效率。无论您是倾向于通过代码定义序列号的开发者，还是需要通过设置快速配置的管理员，Odoo 都能提供灵活的解决方案。遵循本文，您可以为任意模型设置序列号，轻松实现记录的有序化和可追溯性。