<img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg"> <a name="product-profile"></a> <h2>Product Profile</h2> <p>This module provides easier products configuration (in one click). It allows to configure a product template with only one field.</p> <img alt="static/description/field.png" src="static/description/field.png" /> <p><strong>Main use case</strong>: a lot of modules are installed (mrp, purchase, sale, pos) and products configuration becomes harder for end users: too many fields to take care of.</p> <p>You are concerned that at any time a product might be not configured correctly: this module is your friend.</p> <p>Thanks to this module, a lot of complexity becomes hidden (default behavior) to the end user and usability is optimal.</p> <p>It eases as well the data migration by only specifying the profile field instead of all fields which depend on it.</p> <p>Note: This module is meant to be used by skilled people in database fields creation within the ERP framework.</p> <p>Additional feature: a default value can be attached to a profile (see § Configuration, part 3)</p> <a name="configuration"></a> <h2>Configuration</h2> <ol class="arabic simple"> <li>Create your own profile here: Sales &gt; Configuration &gt; Product Categories and Attributes &gt; Product Profiles</li> </ol> <img alt="static/description/list.png" src="static/description/list.png" /> <ol class="arabic simple" start="2"> <li>To have more fields available to attach to this profile you must define these fields in the model 'product.profile' in your own module If the field name (and its type) is the same than those in 'product.template' then values of these will be populated automatically in 'product.template' Example of fields declaration in your own module:</li> </ol> <p><a href="#id1"><span class="problematic" id="id2">``</span></a><a href="#id3"><span class="problematic" id="id4">`</span></a>python</p> <dl class="docutils"> <dt>class ProductProfile(models.Model):</dt> <dd><p class="first">&quot;&quot;&quot; Require dependency on sale, purchase and point_of_sale modules &quot;&quot;&quot;</p> <p>_inherit = 'product.profile'</p> <dl class="docutils"> <dt>def _get_types(self):</dt> <dd><dl class="first last docutils"> <dt>return [('product', 'Stockable Product'),</dt> <dd>('consu', 'Consumable'), ('service', 'Service')]</dd> </dl> </dd> <dt>sale_ok = fields.Boolean(</dt> <dd>string='Can be Sold', help=&quot;Specify if the product can be selected in a sales order line.&quot;)</dd> <dt>purchase_ok = fields.Boolean(</dt> <dd>string='Can be Purchased')</dd> </dl> <p class="last">available_in_pos = fields.Boolean()</p> </dd> </dl> <p><a href="#id5"><span class="problematic" id="id6">``</span></a><a href="#id7"><span class="problematic" id="id8">`</span></a></p> <ol class="arabic simple" start="3"> <li>Second behavior: you might want to add a default behavior to these fields: in this case use prefix 'profile_default_' for your field name in 'product.profile' model.</li> </ol> <p><a href="#id9"><span class="problematic" id="id10">``</span></a><a href="#id11"><span class="problematic" id="id12">`</span></a>python</p> <dl class="docutils"> <dt>class ProductProfile(models.Model):</dt> <dd><p class="first">... profile_default_categ_id = fields.Many2one(</p> <blockquote> 'product.category', string='Default category')</blockquote> <dl class="last docutils"> <dt>profile_default_route_ids = fields.Many2many(</dt> <dd><p class="first">'stock.location.route', string=u'Default Routes', domain=&quot;[('product_selectable', '=', True)]&quot;, help=&quot;Depending on the modules installed, this will allow &quot;</p> <blockquote class="last"> &quot;you to define the route of the product: &quot; &quot;whether it will be bought, manufactured, MTO/MTS,...&quot;)</blockquote> </dd> </dl> </dd> </dl> <p><a href="#id13"><span class="problematic" id="id14">``</span></a><a href="#id15"><span class="problematic" id="id16">`</span></a></p> <blockquote> In this case 'categ_id' field (from product.template) is populated with 'profile_default_categ_id' value but can be updated manually by the user. Careful: each time you change profile, the default value is also populated whatever the previous value. Custom value is only keep if don't change the profile.</blockquote> <ol class="arabic simple" start="4"> <li>Insert data (xml or csv) and define values for each field defined above for each configuration scenario</li> </ol> <a name="usage"></a> <h2>Usage</h2> <p>Assign a value to the profile field in the product template form. Then, all fields which depend on this profile will be set to the right value at once.</p> <p>If you deselect the profile value, all these fields keep the same value and you can change them manually (back to standard behavior).</p> <p>Install <strong>Product Profile Example</strong> module to see a use case in action.</p> <p>Profiles are also defined as search filter and group.</p> <a name="bug-tracker"></a> <h2>Bug Tracker</h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/product-attribute/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/OCA/product-attribute/issues/new?body=module:%20product_profile%0Aversion:%201.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">here</a>.</p> <a name="credits"></a> <h2>Credits</h2> <a name="contributors"></a> <h3>Contributors</h3> <ul class="simple"> <li>David BEAL &lt;<a class="reference external" href="mailto:david.beal&#64;akretion.com">david.beal&#64;akretion.com</a>&gt;</li> <li>Sébastien BEAU &lt;<a class="reference external" href="mailto:sebastien.beau&#64;akretion.com">sebastien.beau&#64;akretion.com</a>&gt;</li> <li>Abdessamad HILALI &lt;<a class="reference external" href="mailto:abdessamad.hilali&#64;akretion.com">abdessamad.hilali&#64;akretion.com</a>&gt;</li> </ul> <a name="iconography"></a> <h3>Iconography</h3> <p><a class="reference external" href="https://www.iconfinder.com/icondesigner">https://www.iconfinder.com/icondesigner</a></p> <a name="maintainer"></a> <h3>Maintainer</h3> <a class="reference external image-reference" href="http://odoo-community.org"><img alt="Odoo Community Association" src="http://odoo-community.org/logo.png" /></a> <p>This module is maintained by the OCA.</p> <p>OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.</p> <p>To contribute to this module, please visit <a class="reference external" href="http://odoo-community.org">http://odoo-community.org</a>.</p>