1. 應(yīng)用場景
ERP系統(tǒng)中需要產(chǎn)生序列號的地方很多亥至，最常見的是各種單據(jù)的單號悼沈、商品的編碼、條碼等等姐扮。這些號碼都需要具有唯一性和連續(xù)遞增性絮供，且根據(jù)具體情況，需要有一定的規(guī)則（比如前綴中含有單據(jù)類型碼茶敏、操作員碼壤靶、日期等）。
2. 手工生成序號
單據(jù)創(chuàng)建時惊搏，將會調(diào)用模型父類的create方法贮乳。我們可以在模型中覆寫父類的create方法，并計算當(dāng)前單據(jù)類型的最新序號恬惯。比如下面這段代碼：
@api.model
def create(self,values):
self.env.cr.execute('select * from xxx_model order by order_code desc limit 1')
x=self.env.cr.dictfetchall()
if len(x)==0:
values['order_code']='0000001'
else:
xx=int(x[0]['order_code'])
xx+=1
xxx=str(xx)
z=xxx
for i in range(6-len(xxx)):
z='0'+z
values['order_code']=z
return super().create(values)
self.env.cr.execute()函數(shù)可以直接執(zhí)行sql語句向拆，但這是一種惰性查詢，真正觸發(fā)數(shù)據(jù)庫查詢動作的是x=self.env.cr.dictfetchall()酪耳，這條語句將查詢結(jié)果賦值給變量x亲铡。這條sql語句的意思是：查找xxx_model中order_code最大的一條記錄。如果沒有找到該記錄葡兑，說明當(dāng)前是首張單據(jù)奖蔓，則給其賦值‘0000001’。若找到記錄讹堤，則將該記錄的order_code轉(zhuǎn)換成int類型吆鹤，加1后再按規(guī)則首位補0，補齊7位洲守。
由于odoo ORM實現(xiàn)了serializable級別的事務(wù)隔離疑务，因此這種生成序列號的方式是沒有問題的沾凄，否則需要通過加鎖的方式確保多用戶同時創(chuàng)建單據(jù)時數(shù)據(jù)庫一致性問題。
3. ir.sequence創(chuàng)建序列號
odoo為我們提供了一個很好用的序列號生成工具ir.sequence知允，使用該工具只需要在數(shù)據(jù)文件中注冊一條ir.sequence記錄撒蟀，在模型代碼中就可以調(diào)用該序列。
3.1 注冊ir.sequence記錄
在需要生成序列號的模型視圖文件中温鸽，添加一條ir.sequence記錄保屯，并可定義序列的前綴規(guī)則，如下：
<record id="seqence_b_purchase_order" model='ir.sequence'>
<field name='name'>Purchase Order</field>
<field name='code'>sequence.purchase_order</field>
<field name='prefix'>%(year)s%(month)s%(day)s</field>
<field name='padding'>5</field>
</record>
prefix字段定義了前綴涤垫，前綴的寫法是一段格式化字符串姑尺，如下是ir.sequence模型中處理前綴的方法，可以看到蝠猬，%(year)s會被解析為%Y切蟋，并通過date的strftime函數(shù)解析出四位數(shù)的年份，month榆芦、day...的處理方法都是如此柄粹。因此，這里可以寫的參數(shù)包括year匆绣、month镰惦、day、y犬绒、doy(day of year)旺入、woy(week of year)、weekday凯力、h23茵瘾、h12、min咐鹤、sec這10種的組合拗秘。還可以添加一些字符串前綴，比如SN祈惶，用來標(biāo)識單據(jù)類別雕旨。
def _get_prefix_suffix(self, date=None, date_range=None):
def _interpolate(s, d):
return (s % d) if s else ''
def _interpolation_dict():
now = range_date = effective_date = datetime.now(pytz.timezone(self._context.get('tz') or 'UTC'))
if date or self._context.get('ir_sequence_date'):
effective_date = fields.Datetime.from_string(date or self._context.get('ir_sequence_date'))
if date_range or self._context.get('ir_sequence_date_range'):
range_date = fields.Datetime.from_string(date_range or self._context.get('ir_sequence_date_range'))
sequences = {
'year': '%Y', 'month': '%m', 'day': '%d', 'y': '%y', 'doy': '%j', 'woy': '%W',
'weekday': '%w', 'h24': '%H', 'h12': '%I', 'min': '%M', 'sec': '%S'
}
res = {}
for key, format in sequences.items():
res[key] = effective_date.strftime(format)
res['range_' + key] = range_date.strftime(format)
res['current_' + key] = now.strftime(format)
return res
d = _interpolation_dict()
try:
interpolated_prefix = _interpolate(self.prefix, d)
interpolated_suffix = _interpolate(self.suffix, d)
except ValueError:
raise UserError(_('Invalid prefix or suffix for sequence \'%s\'') % (self.get('name')))
return interpolated_prefix, interpolated_suffix
除了prefix，也可以有suffix（后綴）捧请、padding凡涩、number_next等重要字段。
padding表示序列號數(shù)字部分的位數(shù)疹蛉，比如padding=5活箕，則序列號為[prefix]00001這樣的類型。
number_next表示序列號的遞增數(shù)可款，比如number_next=1育韩，則下一個序列號比上一個序列號增1克蚂。
3.2 模型中使用序列號
注冊了序列號后，就可以在模型中使用筋讨。需要產(chǎn)生序列號的地方一般在模型的create函數(shù)中埃叭。如下這段代碼：
@api.model
def create(self,values):
try:
values['order_code']=self.env['ir.sequence'].next_by_code('sequence.purchase_order')
stock=self.env['sunrise.u.stock']
if 'order_items' in values.keys():
for item in values['order_items']:
stock_commodity=stock.search([('commodity','=',item[2]['commodity'])])
stock_commodity.amount+=item[2]['amount']
return super().create(values)
except:
raise Exception('b_purchase_order.py:create()')
try中的第一行則使用了上文注冊的序列號，通過self.env['ir.sequence'].next_by_code('sequence.purchase_order')悉罕，可獲取注冊id="seqence_b_purchase_order"這條ir.sequence對象的next_by_code方法赤屋，獲取到最新序號。
