<a class="reference external image-reference" href="https://www.gnu.org/licenses/LGPL"><img alt="License: LGPL-3" src="https://img.shields.io/badge/license-LGPL--3-blue.png" /></a> <a name="base-binary-validation"></a> <h2>Base binary validation</h2> <p>Provide base validation for binary attachments.</p> <p>You can:</p> <ul class="simple"> <li>validate standard attachments on create/write</li> <li>use <cite>BinaryValidated</cite> field to validate them automatically</li> </ul> <p>NOTE: to improve mimetype guessing you should install <cite>libmagic</cite> on you system since Odoo standard leads to random results.</p> <a name="batteries-not-included"></a> <h3>Batteries not included</h3> <p>This module is meant to be used by integrators and developers to add validation to existing or custom models. You won't see any change in Odoo after installing it.</p> <a name="usage"></a> <h4>Usage</h4> <a name="validate-ir-attachment"></a> <h3>Validate <cite>ir.attachment</cite></h3> <p>You can validate standard attachments by providing <cite>allowed_mimetypes</cite> in context:</p> <pre> <code>self.env['ir.attachment'].with_context(allowed_mimetypes=('application/pdf')).create({...})</code> </pre> <a name="validate-fields-w-attachment-true"></a> <h3>Validate fields w/ <cite>attachment=True</cite></h3> <p>Define your field:</p> <pre> <code>from odoo.addons.base_binary_validation.fields import BinaryValidated class Foo(models.Model): [...] terms_conditions = BinaryValidated( string='Terms and Conditions', attachment=True, allowed_mimetypes=('application/pdf', ), )</code> </pre> <p>In both cases, if <cite>allowed_mimetypes</cite> is not satisfied you'll get a validation error.</p> <a name="known-issues-roadmap"></a> <h4>Known issues / Roadmap</h4> <ul class="simple"> <li>Validate non <cite>attachment</cite> binary fields</li> </ul> <a name="bug-tracker"></a> <h4>Bug Tracker</h4> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/server-tools/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 smash it by providing detailed and welcomed feedback.</p> <a name="credits"></a> <h4>Credits</h4> <a name="images"></a> <h3>Images</h3> <ul class="simple"> <li>Odoo Community Association: <a class="reference external" href="https://odoo-community.org/logo.png">Icon</a>.</li> </ul> <a name="contributors"></a> <h3>Contributors</h3> <ul class="simple"> <li>Simone Orsi &lt;<a class="reference external" href="mailto:simone.orsi&#64;camptocamp.com">simone.orsi&#64;camptocamp.com</a>&gt;</li> </ul> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="maintainer"></a> <h3>Maintainer</h3> <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>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="https://odoo-community.org">https://odoo-community.org</a>.</p>