多公司指南¶

警告

This tutorial requires good knowledge of Odoo. Please refer to the Server framework 101 tutorial first if needed.

从13.0版本开始，用户可以同时登录多个公司。这使得用户可以访问多个公司的信息，同时在多公司环境中创建/编辑记录。

如果没有正确管理，它可能是许多不一致的多公司行为的源头。例如，一个同时登录到公司A和公司B的用户可以在公司A创建一个销售订单，并将属于公司B的产品添加到其中。只有当用户从公司B退出登录时，销售订单才会出现访问错误。

为了正确管理多公司行为，Odoo的ORM提供了多种功能：

Company-dependent fields
Multi-company consistency
Default company
Views
Security rules

与公司相关的字段¶

当一条记录可以从多个公司获取时，我们必须预期根据设置值的公司不同，给定字段将分配不同的值。

对于同一记录的字段要支持多个值，必须使用属性 company_dependent 设置为 True 进行定义。

from odoo import api, fields, models

class Record(models.Model):
    _name = 'record.public'

    info = fields.Text()
    company_info = fields.Text(company_dependent=True)
    display_info = fields.Text(string='Infos', compute='_compute_display_info')

    @api.depends_context('company')
    def _compute_display_info(self):
        for record in self:
            record.display_info = record.info + record.company_info

注解

方法 _compute_display_info 被修饰为 depends_context('company') (参见 depends_context)，以确保计算字段根据当前公司 (self.env.company) 重新计算。

当读取一个依赖于公司的字段时，当前公司将被用来检索其值。换句话说，如果用户登录到公司A和B，并将A设置为主要公司，然后为公司B创建一条记录，那么公司依赖字段的值将是公司A的值。

要读取由其他公司设置的与公司相关的字段的值，而不是当前公司，我们需要确保我们使用的公司是正确的。这可以通过 with_company() 来实现，它会更新当前公司。

# Accessed as the main company (self.env.company)
val = record.company_dependent_field

# Accessed as the desired company (company_B)
val = record.with_company(company_B).company_dependent_field
# record.with_company(company_B).env.company == company_B

警告

无论您计算/创建/…的事情在不同的公司中可能会有不同的行为，您都应该确保您所做的事情是在正确的公司中完成的。始终使用 with_company 来避免以后出现问题并不会花费太多。

@api.onchange('field_name')
def _onchange_field_name(self):
 self = self.with_company(self.company_id)
 ...

@api.depends('field_2')
def _compute_field_3(self):
 for record in self:
   record = record.with_company(record.company_id)
   ...

多公司一致性¶

当一条记录通过 company_id 字段在多个公司之间共享时，我们必须确保它不能通过关系字段与另一个公司的记录关联。例如，我们不希望销售订单和其发票属于不同的公司。

为确保多公司的一致性，您必须：

将类属性 _check_company_auto 设置为 True。
如果模型具有 company_id 字段，请使用属性 check_company 设置为 True 来定义关系字段。

在每次 create() 和 write() 操作中，将会触发自动检查以确保记录的多公司一致性。

from odoo import fields, models

class Record(models.Model):
    _name = 'record.shareable'
    _check_company_auto = True

    company_id = fields.Many2one('res.company')
    other_record_id = fields.Many2one('other.record', check_company=True)

注解

字段 company_id 不应该使用 check_company=True 来定义。

Model._check_company(fnames=None)[源代码]¶

Check the companies of the values of the given field names.

参数: fnames (list) – names of relational fields to check
引发: UserError – if the company_id of the value of any field is not in [False, self.company_id] (or self if res_company).

For res_users relational fields, verifies record company is in company_ids fields.

User with main company A, having access to company A and B, could be assigned or linked to records in company B.

警告

The check_company feature performs a strict check! It means that if a record has no company_id (i.e., the field is not required), it cannot be linked to a record whose company_id is set.

注解

当字段上未定义域并且 check_company 设置为 True 时，将添加默认域： ['|', '('company_id', '=', False), ('company_id', '=', company_id)]

默认公司¶

当模型上的字段 company_id 被设置为必填时，一个好的实践是设置一个默认公司。这样可以简化用户的设置流程，甚至在公司被隐藏时保证其有效性。实际上，如果用户没有访问多个公司的权限（即用户没有 base.group_multi_company 组），通常会隐藏公司。

from odoo import api, fields, models

class Record(models.Model):
    _name = 'record.restricted'
    _check_company_auto = True

    company_id = fields.Many2one(
        'res.company', required=True, default=lambda self: self.env.company
    )
    other_record_id = fields.Many2one('other.record', check_company=True)

视图¶

As stated in above, the company is usually hidden from view if the user does not have access to multiple companies. This is assessed with the group base.group_multi_company.

<record model="ir.ui.view" id="record_form_view">
    <field name="name">record.restricted.form</field>
    <field name="model">record.restricted</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <group>
                        <field name="company_id" groups="base.group_multi_company"/>
                        <field name="other_record_id"/>
                    </group>
                </group>
            </sheet>
        </form>
    </field>
</record>

安全规则¶

在处理跨公司共享或限制于单个公司的记录时，我们必须注意用户不能访问属于其他公司的记录。

这是通过基于 company_ids 的安全规则实现的，其中包含用户的当前公司（用户在多公司小部件中选择的公司）。

<!-- Shareable Records -->
<record model="ir.rule" id="record_shared_company_rule">
    <field name="name">Shared Record: multi-company</field>
    <field name="model_id" ref="model_record_shared"/>
    <field name="global" eval="True"/>
    <field name="domain_force">
        ['|', ('company_id', '=', False), ('company_id', 'in', company_ids)]
    </field>
</record>

<!-- Company-restricted Records -->
<record model="ir.rule" id="record_restricted_company_rule">
    <field name="name">Restricted Record: multi-company</field>
    <field name="model_id" ref="model_record_restricted"/>
    <field name="global" eval="True"/>
    <field name="domain_force">
        [('company_id', 'in', company_ids)]
    </field>
</record>

Edit on GitHub