You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

162 lines
4.9 KiB

  1. ===============
  2. Advanced search
  3. ===============
  4. .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. !! This file is generated by oca-gen-addon-readme !!
  6. !! changes will be overwritten. !!
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8. .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
  9. :target: https://odoo-community.org/page/development-status
  10. :alt: Beta
  11. .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
  12. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  13. :alt: License: AGPL-3
  14. .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github
  15. :target: https://github.com/OCA/web/tree/12.0/web_advanced_search
  16. :alt: OCA/web
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/web-12-0/web-12-0-web_advanced_search
  19. :alt: Translate me on Weblate
  20. .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
  21. :target: https://runbot.odoo-community.org/runbot/162/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. More powerful and easy to use search, especially for related fields.
  25. **Table of contents**
  26. .. contents::
  27. :local:
  28. Usage
  29. =====
  30. To use this module, you need to:
  31. * Open *Filters* in a search view
  32. * Select any relational field
  33. * Select operator `is equal to` or `is not equal to`
  34. * The text field changes to a relational selection field where you
  35. can search for the record in question
  36. * Click *Apply*
  37. To search for properties of linked records (ie invoices for customers
  38. with a credit limit higher than X):
  39. * Open *Filters* in a search view
  40. * Select *Add Advanced Filter*
  41. * Edit the advanced filter
  42. * Click *Save*
  43. Note that you can stack searching for properties: Simply add another
  44. advanced search in the selection search window. You can do
  45. this indefinetely, so it is possible to search for moves belonging
  46. to a journal which has a user who is member of a certain group etc.
  47. Known issues / Roadmap
  48. ======================
  49. Improvements to the ``domain`` widget, not exclusively related to this addon:
  50. * Use relational widgets when filtering a relational field
  51. * Allow to filter field names
  52. Improvements to the search view in this addon:
  53. * Use widgets ``one2many_tags`` when searching ``one2many`` fields
  54. * Use widgets ``many2many_tags`` when searching ``many2many`` fields
  55. * Allow to edit current full search using the advanced domain editor
  56. Changelog
  57. =========
  58. 11.0.1.0.2 (2018-10-31)
  59. ~~~~~~~~~~~~~~~~~~~~~~~
  60. * Fix initialization of 1st domain node
  61. Sometime the dialog is not ready yet, like on EE version.
  62. Hence when you inject the 1st domain node
  63. the dialog must be already opened.
  64. [simahawk]
  65. 11.0.1.0.1 (2018-09-18)
  66. ~~~~~~~~~~~~~~~~~~~~~~~
  67. * Fix `undefined` in x2m fields
  68. Before this patch, when searching with the "equals to" operator in any
  69. x2many field, the searched parameter was always `undefined`.
  70. The problem was that the underlying field manager implementation was
  71. treating those fields as x2many, while the widget used was the `one2many`
  72. one.
  73. This patch simply mocks the underlying fake record to make think that
  74. any relational field is always a `one2many`. This sets all pieces in
  75. place and makes the field manager work as expected, and thus you can
  76. search as expected too.
  77. * Make linter happy
  78. [Yajo]
  79. 11.0.1.0.0 (2018-07-20)
  80. ~~~~~~~~~~~~~~~~~~~~~~~
  81. * Rename, refactor, migrate to v11
  82. [Yajo]
  83. Bug Tracker
  84. ===========
  85. Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
  86. In case of trouble, please check there if your issue has already been reported.
  87. If you spotted it first, help us smashing it by providing a detailed and welcomed
  88. `feedback <https://github.com/OCA/web/issues/new?body=module:%20web_advanced_search%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  89. Do not contact contributors directly about support or help with technical issues.
  90. Credits
  91. =======
  92. Authors
  93. ~~~~~~~
  94. * Therp BV
  95. * Tecnativa
  96. Contributors
  97. ~~~~~~~~~~~~
  98. * Holger Brunn <hbrunn@therp.nl>
  99. * Vicent Cubells <vicent.cubells@tecnativa.com>
  100. * Jairo Llopis <jairo.llopis@tecnativa.com>
  101. * Rami Alwafaie <rami.alwafaie@initos.com>
  102. * Jose Mª Bernet <josemaria.bernet@guadaltech.es>
  103. * Simone Orsi <simone.orsi@camptocamp.com>
  104. Maintainers
  105. ~~~~~~~~~~~
  106. This module is maintained by the OCA.
  107. .. image:: https://odoo-community.org/logo.png
  108. :alt: Odoo Community Association
  109. :target: https://odoo-community.org
  110. OCA, or the Odoo Community Association, is a nonprofit organization whose
  111. mission is to support the collaborative development of Odoo features and
  112. promote its widespread use.
  113. This module is part of the `OCA/web <https://github.com/OCA/web/tree/12.0/web_advanced_search>`_ project on GitHub.
  114. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.