<h1 class="title">Connector Importer</h1> <p><a class="reference external" 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" 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" href="https://github.com/OCA/connector-interfaces/tree/15.0/connector_importer"><img alt="OCA/connector-interfaces" src="https://img.shields.io/badge/github-OCA%2Fconnector--interfaces-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/connector-interfaces-15-0/connector-interfaces-15-0-connector_importer"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a></p> <p>This module allows to import / update records from files using the connector framework (i.e. mappers) and job queues.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#known-issues-roadmap" id="id1">Known issues / Roadmap</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="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id1">Known issues / Roadmap</a></h2> <ul class="simple"> <li>with the import of standard Odoo CSV files, a concurrency error occurs when updating the <cite>report_data</cite> of <cite>import_recordset</cite> table (from the importer: <cite>self._do_report()</cite> -&gt; <cite>self.recordset.set_report(...)</cite>). The job is automatically retried a second time (without concurrency errors). For small files it's not a big issue, but for files with a huge amount of lines it takes time to process them two times.</li> <li>refactor the <cite>recordset.full_report_url</cite> field to return a QWeb report instead of a home-made HTML document + display it on the recordset form.</li> <li>move generic functions from <cite>utils.mapper_utils</cite> to the <cite>connector</cite> module</li> <li>unit tests from <cite>tests.test_source_csv</cite> are not imported (Odoo ignores them) and they need to be fixed</li> <li>unit tests for record handler and tracker</li> <li>rely on <cite>self.work.options</cite> in all components to replace all custom flags (eg: <cite>_break_on_error</cite>)</li> </ul> <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/connector-interfaces/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/connector-interfaces/issues/new?body=module:%20connector_importer%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>Camptocamp</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id5">Contributors</a></h3> <p>Simone Orsi (Camptocamp) for the original implementation.</p> <p>Other contributors include:</p> <ul class="simple"> <li>Guewen Baconnier (Camptocamp)</li> <li>Mykhailo Panarin (Camptocamp)</li> <li>Sébastien Alix (Camptocamp)</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>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external" href="https://github.com/simahawk"><img alt="simahawk" src="https://github.com/simahawk.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/connector-interfaces/tree/15.0/connector_importer">OCA/connector-interfaces</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>