<h1 class="title">Attribute Set</h1> <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/odoo-pim/tree/15.0/attribute_set"><img alt="OCA/odoo-pim" src="https://img.shields.io/badge/github-OCA%2Fodoo--pim-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/odoo-pim-15-0/odoo-pim-15-0-attribute_set"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/295/15.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module allows the user to create Attributes to any model. This is a basic module in the way that <strong>it does not provide views to display these new Attributes.</strong></p> <p>Each Attribute created will be related to an <strong>existing field</strong> (in case of a <em>&quot;native&quot;</em> Attribute) or to a newly <strong>created field</strong> (in case of a <em>&quot;custom&quot;</em> Attribute).</p> <p>A <em>&quot;custom&quot;</em> Attribute can be of any type : Char, Text, Boolean, Date, Binary... but also Many2one or Many2many.</p> <p>In case of m2o or m2m, these attributes can be related to <strong>custom options</strong> created for the Attribute, or to <strong>existing Odoo objects</strong> from other models.</p> <p>Last but not least an Attribute can be <strong>serialized</strong> using the Odoo SA module <a class="reference external" href="https://github.com/odoo/odoo/tree/12.0/addons/base_sparse_field">base_sparse_field</a> . It means that all the serialized attributes will be stored in a single &quot;JSON serialization field&quot; and will not create new columns in the database (and better, it will not create new SQL tables in case of Many2many Attributes), <strong>increasing significantly the requests speed</strong> when dealing with thousands of Attributes.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#usage" id="id1">Usage</a></li> <li><a class="reference internal" href="#bug-tracker" id="id2">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id3">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id4">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id5">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id6">Maintainers</a></li> </ul> </li> </ul> </div> <a name="usage"></a> <h2><a class="toc-backref" href="#id1">Usage</a></h2> <p>Even if this module does not provide views to display some model's Attributes, it provides however a Technical menu in <em>Settings &gt; Technical &gt; Database Structure &gt; Attributes</em> to <strong>create new Attributes</strong>.</p> <p>An Attribute is related to both an Attribute Group and an Attribute Set :</p> <ul> <li><p class="first">The <strong>Attribute Set</strong> is related to the <em>&quot;model's category&quot;</em>, i.e. all the model's instances which will display the same Attributes.</p> </li> <li><p class="first">The <strong>Attribute Group</strong> is related to the <em>&quot;attribute's category&quot;</em>. All the attributes from the same Attribute Set and Attribute Group will be displayed under the same field's Group in the model's view.</p> <blockquote> <p>🔎 In order to create a custom Attribute many2one or many2many related to <strong>other Odoo model</strong>, you need to activate the Technical Setting <strong>&quot;Advanced Attribute Set settings&quot;</strong> (<code class="code">group_advanced_attribute_set</code>).</p> </blockquote> </li> </ul> <hr class="docutils" /> <p>If you want to create a module displaying some specific model's Attributes :</p> <ol class="arabic simple"> <li>Your model must <strong>_inherit the mixin</strong> <code class="code">&quot;attribute.set.owner.mixin&quot;</code></li> <li>You need to <strong>add a placeholder</strong> <code class="code">&lt;separator name=&quot;attributes_placeholder&quot; /&gt;</code> at the desired location in the model's form view.</li> <li>Finally, <strong>add a context</strong> <code class="code">{&quot;include_native_attribute&quot;: True}</code> on the action leading to this form view if the model's view needs to display attributes related to native fields together with the other &quot;custom&quot; attributes.</li> </ol> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id2">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/odoo-pim/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 <a class="reference external" href="https://github.com/OCA/odoo-pim/issues/new?body=module:%20attribute_set%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id3">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id4">Authors</a></h3> <ul class="simple"> <li>Akretion</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id5">Contributors</a></h3> <ul class="simple"> <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>Clément Mombereau &lt;<a class="reference external" href="mailto:clement.mombereau&#64;akretion.com.br">clement.mombereau&#64;akretion.com.br</a>&gt;</li> <li>Benoît Guillot &lt;<a class="reference external" href="mailto:benoit.guillot&#64;akretion.com">benoit.guillot&#64;akretion.com</a>&gt;</li> <li>Akretion Raphaël VALYI &lt;<a class="reference external" href="mailto:raphael.valyi&#64;akretion.com">raphael.valyi&#64;akretion.com</a>&gt;</li> <li>David Dufresne &lt;<a class="reference external" href="mailto:david.dufresne&#64;savoirfairelinux.com">david.dufresne&#64;savoirfairelinux.com</a>&gt;</li> <li>Denis Roussel &lt;<a class="reference external" href="mailto:denis.roussel&#64;acsone.eu">denis.roussel&#64;acsone.eu</a>&gt;</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id6">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <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>This module is part of the <a class="reference external" href="https://github.com/OCA/odoo-pim/tree/15.0/attribute_set">OCA/odoo-pim</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>