diff --git a/content/developer/reference/backend/orm.rst b/content/developer/reference/backend/orm.rst index a3c9cee77..a6355c3e8 100644 --- a/content/developer/reference/backend/orm.rst +++ b/content/developer/reference/backend/orm.rst @@ -615,6 +615,12 @@ for partners and one for countries:: country = partner.country_id # first pass prefetches all partners countries.add(country.name) # first pass prefetches all countries +.. seealso:: + The methods :meth:`~odoo.models.Model.search_fetch` and + :meth:`~odoo.models.Model.fetch` can be used to populate the cache of + records, typically in cases where the prefetching mechanism does not work + well. + .. _reference/api/decorators: @@ -845,8 +851,12 @@ Search/Read .. automethod:: Model.search_count +.. automethod:: Model.search_fetch + .. automethod:: Model.name_search +.. automethod:: Model.fetch + .. automethod:: Model.read .. automethod:: Model.read_group diff --git a/content/developer/reference/backend/orm/changelog.rst b/content/developer/reference/backend/orm/changelog.rst index 1651c0146..188c6fbd5 100644 --- a/content/developer/reference/backend/orm/changelog.rst +++ b/content/developer/reference/backend/orm/changelog.rst @@ -4,6 +4,15 @@ Changelog ========= +Odoo Online version 16.2 +======================== + +- Refactor the implementation of searching and reading methods to be able to + combine both in a minimal number of SQL queries. We introduce two new methods + `odoo.models.Model.search_fetch` and `odoo.models.Model.fetch` that take + advantage of the combination. More details can be found on the pull request + `#112126 `_. + Odoo version 16.0 =================