odoo | Odoo Connects Everything

odoo tree view x2many field display (0 records) issue

ODOO列表视图X对多字段显示(n 条记录)问题
考虑到性能和显示的原因，原生One2many多年来一直以条数内容简单显示于固定表格中，其中最为瑕疵的就是无相关数据时的0条记录，这个Many2many也一脉相承，不知道会不会成为洁癖爱好者们心中的痛：）

今天终于等到一个机会忍无可忍精炼代码一并解决名称显示和零记录问题：

/**
 * author: i@renjie.me
 */
var core = require('web.core');
var Model = require('web.DataModel');
var ListView = require('web.ListView');
var ColumnMany2Many = core.list_widget_registry.get('field.many2many');

ColumnMany2Many.include({
    _format: function (row_data, options) {
        var self = this;
        if (_.isEmpty(row_data[this.id].value)) {
            return '';
        }else{
            row_data[this.id] = row_data[this.id + '__display'];
        }
        return self._super.apply(self, arguments);
    }
});
core.list_widget_registry.add('field.one2many', ColumnMany2Many);

ListView.List.include({
    render_cell: function (record, column) {
        var self = this;
        if (column.type === 'one2many') {
            var value = record.get(column.id);
            if (value instanceof Array && !_.isEmpty(value) && !record.get(column.id + '__display')) {
                new Model(column.relation).call('name_get', [
                    value, self.dataset.get_context()
                ]).done(function (names) {
                    record.set(column.id + '__display', _(names).pluck(1).join(', '));
                    record.set(column.id, value);
                });
                record.set(column.id + '__display', false);
            }
            return column.format(record.toForm().data, {
                model: self.dataset.model,
                id: record.get('id')
            });
        }else{
            return self._super.apply(self, arguments);
        }
    }
});

/**

* author: i@renjie.me

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

var Model = require('web.DataModel');

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

var ColumnMany2Many = core.list_widget_registry.get('field.many2many');

ColumnMany2Many.include({

_format: function (row_data, options) {

var self = this;

if (_.isEmpty(row_data[this.id].value)) {

return '';

}else{

row_data[this.id] = row_data[this.id + '__display'];

}

return self._super.apply(self, arguments);

}

});

core.list_widget_registry.add('field.one2many', ColumnMany2Many);

ListView.List.include({

render_cell: function (record, column) {

var self = this;

if (column.type === 'one2many') {

var value = record.get(column.id);

if (value instanceof Array && !_.isEmpty(value) && !record.get(column.id + '__display')) {

new Model(column.relation).call('name_get', [

value, self.dataset.get_context()

]).done(function (names) {

record.set(column.id + '__display', _(names).pluck(1).join(', '));

record.set(column.id, value);

});

record.set(column.id + '__display', false);

}

return column.format(record.toForm().data, {

model: self.dataset.model,

id: record.get('id')

});

}else{

return self._super.apply(self, arguments);

}

});

odoo integrated d3.js visualization position size state view

ODOO集成D3.js可视化位置尺寸状态视图
10版本开始视图根据multi_record布尔属性分为多记录和单记录两种，前者以列表为代表的大部分视图，后者则是表单为经典的单一视图以及神秘的Diagram视图

虽然原生的视图可以满足大部分需求，但是一些特殊的场景用专业的视图展现可以达到事半功倍的效果，如销控图、拓扑图、树状图等

D3.js是一个非常优秀的前端可视化库，其数据驱动的理念与ODOO完美互补：前者负责美丽娇艳，后者提供关系数据：）

销控图

odoo tree view disable open form content

ODOO列表视图禁止打开表单内容
正常的列表视图做为菜单动作直接打开的话，直接点击是跳转当前动作下的表单视图；还有一种是做为表单视图One2many、Many2many类型的嵌入式列表视图，直接点击打开Dialog窗口展示表单视图，一些特殊的需求场景下往往希望只将信息展示到列表即止，不用更多的详细互动：

/**
 * author: i@renjie.me
 */
var ListView = require('web.ListView');
ListView.List.include({
    row_clicked: function () {
        var self = this;
        var context = self.dataset.get_context().eval();
        if(!context["disable_open"]){
            self._super.apply(self, arguments);
        }
    }
});

/**

* author: i@renjie.me

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

ListView.List.include({

row_clicked: function () {

var self = this;

var context = self.dataset.get_context().eval();

if(!context["disable_open"]){

self._super.apply(self, arguments);

}

});

原理就是找到相关的行点击入口，通过万能的context扩展一个独立的禁止打开参数，默认不禁止，视图里通过显式声明使用该功能：

<field name="renjie_ids" context="{'disable_open': True}"/>

1	<field name="renjie_ids" context="{'disable_open': True}"/>

odoo qweb report black solid line border table

ODOO QWeb报表黑色实线边框表格
原生报表表格的默认边框如下：

表格无边框

除了抬头一横条黑线外，剩下的灰线在针式打印下约等于无，非常没有整体感
根据Bootstrap标准和Less规范精炼了一段CSS预处理代码：

/*
    author: i@renjie.me 
*/
.table-bordered{
    border: 1px solid black;
    > thead, > tbody, > tfoot{
        > tr{
            > th, > td{
                border: 1px solid black;
            }
        }
    }
}
.table-condensed{
    .table-bordered
}

author: i@renjie.me

.table-bordered{

border: 1px solid black;

> thead, > tbody, > tfoot{

> tr{

> th, > td{

border: 1px solid black;

}

.table-condensed{

.table-bordered

}

可以直接添加到源码addons/report/static/src/less/report.less最后，也可以通过间接继承report.assets_common模板视图的根位置插入一个link元素less新文件

表格有边框

odoo form view action edit mode open

ODOO表单视图动作编辑模式打开
表单有两种模式，分别是view浏览和edit编辑，一般通过动作跳转的默认都是浏览模式，需要额外点击编辑按扭切换成编辑模式，对一些要求快速编辑的场景来说显得有些多余

ODOO10截止目前的版本已经可以直接通过action flags对象来透传initial_mode参数，具体用法如下：

'''
  author: i@renjie.me
'''
@api.multi
def action_edit_partner(self):
    self.ensure_one()
    return {
        'type': 'ir.actions.act_window',
        'view_type': 'form',
        'view_mode': 'form',
        'res_model': 'res.partner',
        'res_id': 1,
        'context': self.env.context,
        'flags': {'initial_mode': 'edit'},
    }

'''

author: i@renjie.me

'''

@api.multi

def action_edit_partner(self):

self.ensure_one()

return {

'type': 'ir.actions.act_window',

'view_type': 'form',

'view_mode': 'form',

'res_model': 'res.partner',

'res_id': 1,

'context': self.env.context,

'flags': {'initial_mode': 'edit'},

}

早期的版本虽然不支持，但是对于dict类型来说，也是可以通过return透传给前端拿到，只需额外添加一个通用的桥接口中转下即可：

/**
 * author: i@renjie.me
 */
var FormView = require('web.FormView');
FormView.include({
    init : function(parent, dataset, views, flags, options){
        var self = this;
        options = options || {};
        if(flags && flags.initial_mode){
            options.initial_mode = flags.initial_mode;
        }
        self._super.apply(self, arguments);
    }
});

/**

* author: i@renjie.me

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

FormView.include({

init : function(parent, dataset, views, flags, options){

var self = this;

options = options || {};

if(flags && flags.initial_mode){

options.initial_mode = flags.initial_mode;

}

self._super.apply(self, arguments);

}

});

odoo tree view dynamic column

ODOO列表视图动态列
由于框架模型限定了字段是需要事先定义的，也就是个数是确定的，对应成列表视图仅仅是显示或者不显示这些字段而已

时间横排

一些特殊的场景，比如工时单记录，根据项目在列表视图上一行行的填写工时就变得非常重复和多余，可惜官方没有改造列表视图使其获得通用能力，而是专门为之新开发了一个项目日期横排组件级视图，使得应用范围比较窄，多些固定列或者非时间动态列的情况下就无法直接使用了

尺码横排

一些行业的应用，比如服装行业的尺码横排，动态列一般是浮点型价格或者整型数量，而固定列除了颜色之外，一般还有批次、仓位、款式、订单等组合。前期也参考了工时单和Grid视图的优秀设计，甚至尝试基于其进行二次开发改良，但最终还是选择最普遍的原生列表视图为基础进行扩展，希望最终用户可以获得习惯一致的体验，同时也对经典视图深入发展多元化应用进行了一次实打实的尝试

odoo mail delivery integration

ODOO邮件发送集成
电子邮件这个场景在国外集成率非常高，国内则相对少很多。一是因为文化习惯，而且我们还有微信、钉钉；二是因为Mail模块是针对国际化普世标准设计的，如Gmail、Postfix，不太适合中国大部分中小企业还在用腾讯、网易企业邮箱服务的国情

所以新手在中国要完美使用邮件集成是折腾的，这里我们先将问题一分为二，按照顺序从发送开始说，理解透彻了发送模式对后续接收及分发原理会有一定的帮助

相关系统参数：
mail.bounce.alias（默认值bounce，无界面设置）
mail.catchall.domain（默认值odoo域名，可以在通用设置别名域里设置）

发送账号配置：
默认localhost用于本地自建smtp邮件发送服务器使用，如Postfix服务
一般配置成企业邮箱专门为之新建的一个ODOO账号，如odoo@renjie.me

发件名义原则：
1、系统邮件如新用户邀请、密码重置等以公司Email设置里的邮箱名义发送，如info@renjie.me
2、个人邮件如操作者自己的业务沟通，以用户对应的联系人Email设置里的邮箱名义发送，如i@renjie.me

三大发送模式：
1、简单发送（mail.catchall.domain不设置）
直接用发送账号发出，发件人需要与发送账号相同或者是其同一账号下的其他别名，否则会被邮件系统拒绝，如SMTPSenderRefused: 501 mail from address must be same as authorization user test@renjie.me。接收方也直接回复该真实地址，非常容易理解，属于最原始的模式，最适合做邮件通知这种只集成发送不用集成接收的情况

2、代理发送（mail.catchall.domain设置，mail.bounce.alias不设置）
间接用postmaster-odoo账号代发出，发送账号需要具有该名称授权，否则也会被邮件系统拒绝，如SMTPSenderRefused: 501 mail from address must be same as authorization user postmaster-odoo@renjie.me。接收方默认回复catchall专用地址，由于属于代发，且发件地址、代发地址、回复地址都可以不相同，第一次使用还会有些颠覆邮箱观，甚至某些客户端出于谨慎还会出现欺诈提醒，但这确是目前国内用的最多的务实模式，大部分教程都是以此展开详解

3、反弹发送（mail.catchall.domain设置，mail.bounce.alias设置）
间接用bounce地址代发出，如bounce+5-res.users-2@renjie.me或者bounce+5@renjie.me，其中+5为邮件流水号，-2为单据流水号，可见前者还是单据相关邮件，接收方也默认回复catchall专用地址，因为其涉及到邮件接收等相关知识，而且国内免费邮箱服务基本没有完美支持，本文将不深入探讨，待以后ODOO邮件接收集成的时候在讨论如何配合Postfix实现完美收发自如

odoo document management system

ODOO文档管理系统
自从开始玩上官方应用市场，一直坚持平均一个月推出一款应用，日积月累也慢慢形成了移动互联网流行的应用矩阵，同时也对海外客户的国际化需求和口味风格异同都有了不少的了解

今天突然发现上个月发布的一款文档管理系统今天已经进入下载排名十强，目前位于第八个的样子，这可是破记录了，因为之前最高也就是在第二页徘徊而已。曾经也羡慕过那些霸榜应用，现在看来只要坚持总会摸索到爆款痛点：）

论市场优秀应用，我认为至少要同步官方的节奏，不仅要支持最新的三个版本，更要兼容企业版，当然最重要的还是开源免费，而开发者所收获的则是国际的规范的扎实的基础能力

https://apps.odoo.com/apps/modules/10.0/document_management_system/

odoo web window title config app

ODOO浏览器窗口标题配置模块
前文odoo custom web window title已经讲解了基础原理，虽然代码很简洁易懂，但对非开发出身的odoo玩家使用还是有一些难度，而且不同版本可能还会有一些实施细节上的差异

整体开箱即用、细节精益求精是我毕生追求的odoo一体化目标，周末趁这个小机会将其一步到位适配成8、9、10三大主流版本全覆盖的模块，并已发布到odoo官方应用市场，支持在线自动安装，也可以下载相应的版本到本地进行传统手动安装

https://apps.odoo.com/apps/modules/8.0/web_window_title/
https://apps.odoo.com/apps/modules/9.0/web_window_title/
https://apps.odoo.com/apps/modules/10.0/web_window_title/

odoo-web-window-title-app

odoo form view document directory upload

ODOO表单视图文档目录上传
关于附件上传的可行性体验优化，目前国际上最多最成熟的方案都是扩展支持多选和拖拽两种方式，也能极大的改善ODOO原生的单附件上传模式
但是如果追求极致的话还可以扩展支持文档目录直接上传，一次选择操作就可以将目录里的所有文件全部上传，无论目录有多少层级多少子目录全部一网打尽

基础结构：file元素添加html5新特性

<input type="file" webkitdirectory="true" mozdirectory="true" msdirectory="true" odirectory="true" directory="true" class="o_form_file_upload_input"/>

1	<input type="file" webkitdirectory="true" mozdirectory="true" msdirectory="true" odirectory="true" directory="true" class="o_form_file_upload_input"/>

PS：一堆浏览器私有前缀属性仿佛又回到了IE多版本称霸年代：）

事件支持：odoo form view document multi upload
居然上次多选上传的代码直接支持，可见写的一手兼容未来代码的重要性

有图有真相：Linux都兼容，Win、Mac理论不在话下。。。

目录上传

目录上传选择

目录上传结果

参考资料：
https://docs.microsoft.com/en-us/microsoft-edge/dev-guide/html5/folder-upload
https://developer.mozilla.org/en-US/Firefox/Releases/50