Search 1.9 billion lines of Odoo code on GitHub
default_warehouse_from_sale_team
<img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
<a name="default-warehouse-from-sales-team"></a>
<h2>Default Warehouse from Sales Team</h2>
<a name="usage"></a>
<h3>Usage</h3>
<p>Add a field <cite>Default Warehouse</cite> in sales team.</p>
<p>Create sort kind of api where any object with field called warehouse_id will
take the default value from the sales team field
this taking into account the team defined in <cite>Default Sale Teams</cite> field defined
in the res.user model.</p>
<p>To improve, consistency and usability we add the following features:</p>
<ul>
<li><p class="first">If you try to add a default sales team where the user doesn't belongs wil throw
you an error message: Can not set default team is do not belongs to sale team</p>
</li>
<li><p class="first">Add an automated action/server action to update the user default sales team
every time that a sales teams by:</p>
<blockquote>
<ul class="simple">
<li>add user's default sale team if empty.</li>
<li>remove default sale team from user if not longer in sale team.</li>
<li>dummy write to update m2m in users to make new feature for filtering
records.</li>
</ul>
</blockquote>
</li>
</ul>
<p>Currently this default warehouse feature applies for:
- Sale orders
- Transfers (<code>stock.picking</code>)
- Operation type (<code>stock.picking.type</code>)</p>
<p>Also add a new feature for Permissions and Security: Taking advantage of the
default_warehouse field in the sales team model now we can filter the
records (picking type and picking model) to only show those records that match
with the user sale teams default_warehouse. To accomplish this I:</p>
<ul class="simple">
<li>add new groups to manage the records access by user:<ul>
<li>Default Warehouse / Limited access to transfers (filtered by sales team)</li>
<li>Default Warehouse / Limited access to operation types (filtered by sales team)</li>
<li>Default Warehouse / Access to all operation types</li>
<li>Default Warehouse / Access to all transfers</li>
</ul>
</li>
<li>add new m2m field in the res.user model used in the new ir.rules.
this onw is showed as a readonly field (only informative) to know
the teams were the sale user belongs.</li>
<li>add new ir.rule records, one for each default warehouse group. This
one will let us to only show the records for the current user sale
teams default_warehouse or to do not take into account the sale teams
and show all the records to the user.</li>
</ul>
<p>To add more models use it simple do this:</p>
<ol class="arabic">
<li><p class="first">Inherit the class that you want to set the field warehouse_id:</p>
<pre>
<code>class SomeClass(models.Model):
_name = 'some.class'
_inherit = ['some.class', 'default.warehouse']
warehouse_id = fields.Many2one('stock.warehouse', help='Warehouse were'
'this object will belong to')</code>
</pre>
</li>
<li><p class="first">Create two ir.rule to filter stock.picking and stock.picking.type taking
into account the current user warehouses. When a user is part of warehouse
teams will be able to access only the records related to that warehouses:</p>
<pre>
<code><record id="rule_group_model" model="ir.rule">
<field name="name">Limited access to model (filtered by sales teams)</field>
<field name="model_id" search="[('model','=','model')]" model="ir.model"/>
<field name="groups" eval"[Command.set([ref('xml_id_group')])]/>
<field name="domain_force">[('warehouse_id', 'in', [team.default_warehouse.id for team in user.sale_team_ids if team.default_warehouse])]</field>
</record>
<record id="rule_group_model_2" model="ir.rule">
<field name="name">Access to all model</field>
<field name="model_id" search="[('model','=','model')]" model="ir.model"/>
<field name="groups" eval"[Command.set([ref('xml_id_group')])]/>
<field name="domain_force">[(1, '=', 1)]</field>
</record></code>
</pre>
</li>
<li><p class="first">Don't forget depends of this module adding it to the list into <cite>__openerp__.py</cite>:</p>
<pre>
<code>The default value from this field will be the warehouse setted in the section.
If the user is not related to a sales team or not warehouse setted on the
section the default warehouse will be set using the default behavior of the
system which is assign the main warehouse.</code>
</pre>
</li>
</ol>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on
<a class="reference external" href="https://github.com/Vauxoo/addons-vauxoo/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and
welcomed feedback
<a class="reference external" href="https://github.com/Vauxoo/addons-vauxoo/issues/new?body=module:%20default_warehouse_from_sale_team%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">here</a></p>
<a name="credits"></a>
<h3>Credits</h3>
<p><strong>Contributors</strong></p>
<ul class="simple">
<li>Nhomar Hernández <<a class="reference external" href="mailto:nhomar@vauxoo.com">nhomar@vauxoo.com</a>> (Planner/Developer)</li>
<li>Katherine Zaoral <<a class="reference external" href="mailto:kathy@vauxoo.com">kathy@vauxoo.com</a>> (Planner/Developer)</li>
<li>Luis González <<a class="reference external" href="mailto:lgonzalez@vauxoo.com">lgonzalez@vauxoo.com</a>> (Developer)</li>
<li>Rolando Duarte <<a class="reference external" href="mailto:rolando@vauxoo.com">rolando@vauxoo.com</a>> (Developer)</li>
</ul>
<a name="maintainer"></a>
<h3>Maintainer</h3>
<a class="reference external image-reference" href="https://www.vauxoo.com"><img alt="Vauxoo" src="https://s3.amazonaws.com/s3.vauxoo.com/description_logo.png" style="width: 200px;" /></a>
<p>This module is maintained by Vauxoo.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://www.vauxoo.com">https://www.vauxoo.com</a>.</p>