web/wdoc/custom_view_en.rst
author Vladimir Popescu <vladimir.popescu@logilab.fr>
Tue, 02 Apr 2013 12:11:44 +0200
changeset 8832 26cdfc6dd6f8
parent 0 b97547f5f1fa
child 10218 5ebbaf713caf
permissions -rw-r--r--
[dataimport] Uniformize the API across the different stores. This is achieved by modifying the ``relate`` method so that it takes an extra ``**kwargs``. More specifically, ``SQLGenObjectStore``'s ``relate`` method needs the the type of the subject entity which is passed through ``**kwargs`` as the ``subjtype`` keyword argument. Actually, it is the ``add_relation`` method of the ``SQLGenObjectStore`` who needs this argument. However, as this method is not called directly (but via the ``relate`` method), the ``subjtype`` argument is passed to ``add_relation`` via ``relate``. The other stores' ``relate`` methods do not need this extra argument, hence for the other stores ``**kwargs`` is empty. In this manner, the API is unified across the different stores.

Once you have read the `RQL tutorial`_ and you know the application'`schema`_,
you're ready to define your own views. Just type the RQL query retreiving data
you're interested in in the search field. If the view used to display them
doesn't fit your need, choose another one in the possible views box (this box
isn't displayed by default, but you can activate it in your `user
preferences`_). Once you're satified, add a `bookmark`_ if you want to reuse
this view later.

.. _`RQL tutorial`: doc/tut_rql
.. _`schema`: schema
.. _`user preferences`: myprefs
.. _`bookmark`: doc/bookmarks


Below are some example of what can be acheived...

.. winclude:: custom_view_last_update
.. winclude:: custom_view_rss