summaryrefslogtreecommitdiff
path: root/doc/reference
diff options
context:
space:
mode:
authorChristophe Simonis <chs@odoo.com>2015-01-26 15:46:24 +0100
committerChristophe Simonis <chs@odoo.com>2015-01-26 15:46:24 +0100
commite19ec6a8be9fb6ae857199b7048e3294aa68ab8b (patch)
tree9de8239d328f908fa4bc6574b1c0bc674a09f797 /doc/reference
parent1f3ab82f773e1497d8c1258a608bd1f402b40181 (diff)
parent4e6251581905d74fd3f48a538c259f8a3425d2de (diff)
[MERGE] forward port of branch 8.0 up to 4e62515
Diffstat (limited to 'doc/reference')
-rw-r--r--doc/reference/orm.rst20
1 files changed, 13 insertions, 7 deletions
diff --git a/doc/reference/orm.rst b/doc/reference/orm.rst
index 474f0eee895..6b609e52287 100644
--- a/doc/reference/orm.rst
+++ b/doc/reference/orm.rst
@@ -1,14 +1,19 @@
.. _reference/orm:
-===
-ORM
-===
+=======
+ORM API
+=======
Recordsets
==========
.. versionadded:: 8.0
+ This page documents the New API added in Odoo 8.0 which should be the
+ primary development API going forward. It also provides information about
+ porting from or bridging with the "old API" of versions 7 and earlier, but
+ does not explicitly document that API. See the old documentation for that.
+
Interaction with models and records is performed through recordsets, a sorted
set of records of the same model.
@@ -444,8 +449,8 @@ Clearing caches can be performed using the
.. _reference/orm/oldapi:
-Old API compatibility
-=====================
+Compatibility between new API and old API
+=========================================
Odoo is currently transitioning from an older (less regular) API, it can be
necessary to manually bridge from one to the other manually:
@@ -1026,9 +1031,10 @@ Domain criteria can be combined using logical operators in *prefix* form:
AND (language is NOT english)
AND (country is Belgium OR Germany)
-Porting from the old API
-========================
+Porting from the old API to the new API
+=======================================
+* bare lists of ids are to be avoided in the new API, use recordsets instead
* methods still written in the old API should be automatically bridged by the
ORM, no need to switch to the old API, just call them as if they were a new
API method. See :ref:`reference/orm/oldapi/bridging` for more details.