仁杰 | Odoo Connects Everything

odoo list view sequence number backend solution

ODOO列表视图序号后端解决方案
市场上很多是基于前端二次开发的，比如在列表头增加首列做为序号列，由于需要对列表的页面结构进行一些覆盖式的修改，导致不同版本之间的兼容性很差，且同类型模块之间也很容易冲突

'''
  author: i@renjie.me
'''
class Sequence(models.AbstractModel):
    _name = 'renjie.sequence'
    _description = u'序号类'

    sequence = fields.Integer(u'序号', default=0)

    @api.model
    def search_read(self, domain=None, fields=None, offset=0, limit=None, order=None):
        res = super(Sequence, self).search_read(domain, fields, offset, limit, order)
        if fields and "sequence" in fields:
            index = offset
            for rec in res:
                index += 1
                rec["sequence"] = index
        return res

    @api.multi
    def read(self, fields=None, load='_classic_read'):
        res = super(Sequence, self).read(fields, load=load)
        if fields and "sequence" in fields:
            index = 0
            for rec in res:
                index += 1
                rec["sequence"] = index
        return res

'''

author: i@renjie.me

'''

class Sequence(models.AbstractModel):

_name = 'renjie.sequence'

_description = u'序号类'

sequence = fields.Integer(u'序号', default=0)

@api.model

def search_read(self, domain=None, fields=None, offset=0, limit=None, order=None):

res = super(Sequence, self).search_read(domain, fields, offset, limit, order)

if fields and "sequence" in fields:

index = offset

for rec in res:

index += 1

rec["sequence"] = index

return res

@api.multi

def read(self, fields=None, load='_classic_read'):

res = super(Sequence, self).read(fields, load=load)

if fields and "sequence" in fields:

index = 0

for rec in res:

index += 1

rec["sequence"] = index

return res

上述代码将虚拟序号的功能封装为标准抽象模型，适用于模块按需继承给视图直接使用即可

odoo one2many2many mix field model

ODOO一对多对多混合字段模型
原生的One2many和Many2many已经可以解决大部分模型之间的关系映射，但在一些特殊场景下还是需要混合两者优点形成一个新的关系模型

odoo one2many2many mix field model

如生产制造相关的部件与工序：一个部件是由多个工序所组成，而其工序之间还有调整顺序等要求；一个工序可以在多个部件里的不同位置所引用，也可以在同一个部件里不同顺序多次引用

标准的一对多模型桥接做映射可以自定义明细行顺序、独立参数。缺点是只能一个个添加，无法直接打开被桥接的模型进行操作
标准的多对多模型直接做映射可以批量选择、直接编辑。缺点是不可重复且没有顺序及独立参数，后续基本没有可扩展的灵活性
混合的一对多对多模型则是结合上述两者各自优势进行互补以达到可用性层面的最佳用户体验

ODOO12新起点
终于迎来了12，也是传说中期待的双数版本号
去年这个时候是11，虽也惊喜，但毕竟是python2到3的过渡期，有历史责任包袱的产品还是需要双兼容，于是那个版本是从7持续以来第一个被忽视的版本
所以我们现在的感觉就如同当年还在Windows Mobile的odoo78910，因为专注取舍错过了整个Symbian过渡时期，然后一口气飞奔进入iOS/Android双雄争霸时代
这比喻也许有些夸张，但对定位为开源企业级应用操作系统的我们来说，还是比较合适的：）

随着新产品线开始全面拥抱odoo12已经一个月有余，目前各种感觉都很顺畅，真不愧是一个全新的高起点定制系统：
框架模式方面基本成型，落后的能淘汰的都淘汰了，缺陷的能优化的也都优化了，结构上开始趋向稳定，预计未来大版本升级会容易很多
数据库方面过去成熟稳定的PostgreSQL9低版本已经无法胜任，久违的ORM开始慢慢的启用了一些新特性，长远发展看pg10+要成为标配
XML视图方面更新了更为严谨的rng约束，各种元素及属性将不可随意添加或缺失，有效的规范了页面结构的整体质量
CSS样式方面预处理器由Less改成了与整体框架更为融洽的Scss，核心的Bootstrap库大版本也从经典的3升级到了最新的4，感觉表现层这系列折腾起码要稳定几年了
Python方面彻底进入3时代，以后可能还有一些3.7前后版本的对应兼容库问题，但总算是完全告别2时代了
JavaScript方面基本已经将odoo9以来奠定的框架基础改造至极限，虽不能说很完美，但这一路优化过来已属不易，二次可开发的地方也越多越完善，将来Hack代码的机会不多了

其他应用层面的变化太多就不一一列举了，这里就重点说一个原来的document模块要废弃了，其在表单顶部工具栏的文档附件管理已被底部的mail消息日志功能所整合替代。长远看这也是一个很好的改进，只是可惜了原来依赖该基础模块的一大波第三方模块要被迫转型升级。考虑到要适应多年以来形成的附件操作习惯突然改变，同时我们自己也有直接间接依赖的几十号各类模块需要以空间换时间的兼容使用，特此立项从12版本开始上架维护用于替代的Document Sidebar模块，该应用市场链接https://apps.odoo.com/apps/modules/12.0/document_sidebar/

document_sidebar

odoo integrated excel xls and xlsx file read write library

ODOO集成Excel xls和xlsx文件读写库
开源物以类聚角度LibreOffice Calc的ods格式是整合电子表格的最佳选择，但由于Excel尾大不掉还有着2003及之前xls格式和2007及之后xlsx格式的历史问题

存储：原生Binary字段是最合适的，但不管最终是文件存储还是数据库存储，程序上都是以base64库的encodestring编码和decodestring解码进行出入

前端：SheetJS库可以用来做附件和报表的预览应用及所见即所得数据的快速结构化导出

后端：xlrd+xlwt、XlsxWriter、OpenPyXL三大Python库各有所长又相互制衡反垄断，根据场景自由组合起来可以做各种类型复杂应用。StringIO和BytesIO可用于中转处理过程中的内存临时存储，避免了要生成和清理文件的麻烦

odoo list view dynamic row selection field

ODOO列表视图动态行选择字段
由于框架模型限定了选择字段是需要事先定义的，也就是选择下拉内容是确定且固定的，对应成列表视图则是每一行都是相同有限的选择

物料颜色和规格集

比如以上这种每一个物料都有自己的颜色和规格明细组合，这与odoo原生的产品变体刚好相反，后者是由产品属性及值自动生成所有排列组合的变体，前者则根据实际有限的明细反推出其属性集合

物料颜色规格选择

最后体现在一些行业应用中，比如鞋服箱包产品款式的BOM配色配码，其颜色尺码的表头是由产品基础属性组成动态列，而颜色规格的配置行则是根据所选物料的不同集合来动态限定范围选择列，间接实现每一行的Many2one和Selection字段都是独立定义

odoo list view table tr hover background color

ODOO列表视图表格行悬停背景色
原生列表的鼠标悬停和点击选择一样，都是没有特别的视觉效果，有些列和数据都非常多的场景，满屏都是数据逐行浏览下来很疲劳

/*
    author: i@renjie.me
*/
.o_list_view {
    tbody {
        tr {
            &:hover {
                background-color: #f0eeee;
            }
        }
    }
}

author: i@renjie.me

.o_list_view {

tbody {

tr {

&:hover {

background-color: #f0eeee;

}

一段简洁的less代码轻松搞定，odoo就像纯净的简装房，其框架结构非常优秀，但不同的应用需要对其各种细节进行个性化精装修才能获得最佳体验：）

odoo search view touch device disable auto focus

ODOO搜索视图触屏设备禁用自动聚焦
标准搜索视图都是配合其他数据视图组合呈现的，其有个特性就是会自动获取焦点到搜索输入框方便用户快速进行数据筛选

如今大部分的移动设备如手机、平板等都是使用软键盘进行触控输入，当系统检测到焦点被可输入元素获取到时会自动弹出占用将近一半屏幕大小的虚拟键盘。如此搜索视图那原本人性化的设计在移动设备下日常使用动不动就被弹出键盘的行为反而变的更不友好

经过源码分析若不覆盖原设计方法冗余重构的情况下还有自动失焦的对冲方案，同时这个效果也是Web浏览器经典的UI线程和JS线程互斥表现演示：

/**
 * author: i@renjie.me
 */
var config = require('web.config');
var SearchView = require('web.SearchView');
SearchView.include({
    renderFacets: function() {
        var self = this;
        self._super.apply(self, arguments);
        if (config.device.touch) {
            var input_view = _.last(self.input_subviews);
            if(input_view){
                input_view.$el.blur();
            }
        }
    }
});

/**

* author: i@renjie.me

var config = require('web.config');

var SearchView = require('web.SearchView');

SearchView.include({

renderFacets: function() {

var self = this;

self._super.apply(self, arguments);

if (config.device.touch) {

var input_view = _.last(self.input_subviews);

if(input_view){

input_view.$el.blur();

}

});

odoo html field summernote wysiwyg editor custom

ODOO富文本字段Summernote编辑器自定义
Summernote是一个非常简单灵活所见即所得的HTML在线编辑器，基于jQuery和Bootstrap构建，支持快捷键操作，提供大量可定制的选项

不同版本的ODOO在不同阶段都尝试过各种自定义，比如字体选择、全屏功能以及开发者模式下的源码视图，以下将根据代码odoo/addons/web_editor/static/src/js/backend.js里的默认配置为基础进行自定义调整：

/**
 * author: i@renjie.me
 */
var FieldTextHtmlSimple = core.form_widget_registry.get("html");
FieldTextHtmlSimple.include({
    _config: function() {
        var self = this;
        var config = self._super.apply(self, arguments);
        // 初始高度
        config["height"] = 200;
        // 删除线功能
        config.toolbar[1][1].splice(3, 0, 'strikethrough');
        // 普通模式源码视图
        if(!session.debug){
            config.toolbar.splice(7, 0, ['view', ['codeview']]);
        }
        // 全屏功能
        config.toolbar[7][1].unshift('fullscreen');
        return config;
    },
    initialize_content: function() {
        var self = this;
        self._super.apply(self, arguments);
        // 关闭拼写检查
        if(!self.get("effective_readonly")){
            self.$content.attr("spellcheck", false);
        }
    }
});

/**

* author: i@renjie.me

var FieldTextHtmlSimple = core.form_widget_registry.get("html");

FieldTextHtmlSimple.include({

_config: function() {

var self = this;

var config = self._super.apply(self, arguments);

// 初始高度

config["height"] = 200;

// 删除线功能

config.toolbar[1][1].splice(3, 0, 'strikethrough');

// 普通模式源码视图

if(!session.debug){

config.toolbar.splice(7, 0, ['view', ['codeview']]);

}

// 全屏功能

config.toolbar[7][1].unshift('fullscreen');

return config;

initialize_content: function() {

var self = this;

self._super.apply(self, arguments);

// 关闭拼写检查

if(!self.get("effective_readonly")){

self.$content.attr("spellcheck", false);

}

});

summernote

odoo integrated raphaël visualization marketing control view

ODOO集成Raphaël可视化销控视图
Raphaël 是一个用于在网页中绘制矢量图形的 Javascript 库。它使用 SVG W3C 推荐标准和 VML 作为创建图形的基础，你可以通过 JavaScript 操作 DOM 来轻松创建出各种复杂的柱状图、饼图、曲线图等各种图表，还可以绘制任意形状的图形，可以进行图表或图像的裁剪和旋转等复杂操作

虽然 D3.js 已经非常优秀，但多一个选择也不是坏事，何况理论上各种优秀的前端图形库都可以按照 ODOO 视图规范兼容共处一起飞：）

地产销控图

作者：仁杰

民国福建金门金湖遥望大陆晋江金井

odoo list view sequence number backend solution

odoo one2many2many mix field model

odoo12 new starting point

odoo integrated excel xls and xlsx file read write library

odoo list view dynamic row selection field

odoo list view table tr hover background color

odoo search view touch device disable auto focus

odoo html field summernote wysiwyg editor custom

odoo integrated raphaël visualization marketing control view