doc/report-declaration.rst

   1 .. _report-declaration:
   2
   3 Report declaration
   4 ==================
   5
   6 .. versionadded:: 7.1
   7
   8 Before version 7.1, report declaration could be done in two different ways:
   9 either via a ``<report>`` tag in XML, or via such a tag and a class
  10 instanciation in a Python module. Instanciating a class in a Python module was
  11 necessary when a custom parser was used.
  12
  13 In version 7.1, the recommended way to register a report is to use only the
  14 ``<report>`` XML tag. The tag can now support an additional ``parser``
  15 attribute. The value for that attibute must be a fully-qualified class name,
  16 without the leading ``openerp.addons.`` namespace.
  17
  18 .. note::
  19   The rational to deprecate the manual class instanciation is to make all
  20   reports visible in the database, have a unique way to declare reports
  21   instead of two, and remove the need to maintain a registry of reports in
  22   memory.
  23