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.

166 lines
5.1 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/11.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-11-0/web-11-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/11.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. * Allow to edit individually any facet from current search using the
  57. advanced domain editor
  58. * Beautiful, human-readable, domain representation when adding an
  59. advanced filter
  60. Changelog
  61. =========
  62. 11.0.1.0.2 (2018-10-31)
  63. ~~~~~~~~~~~~~~~~~~~~~~~
  64. * Fix initialization of 1st domain node
  65. Sometime the dialog is not ready yet, like on EE version.
  66. Hence when you inject the 1st domain node
  67. the dialog must be already opened.
  68. [simahawk]
  69. 11.0.1.0.1 (2018-09-18)
  70. ~~~~~~~~~~~~~~~~~~~~~~~
  71. * Fix `undefined` in x2m fields
  72. Before this patch, when searching with the "equals to" operator in any
  73. x2many field, the searched parameter was always `undefined`.
  74. The problem was that the underlying field manager implementation was
  75. treating those fields as x2many, while the widget used was the `one2many`
  76. one.
  77. This patch simply mocks the underlying fake record to make think that
  78. any relational field is always a `one2many`. This sets all pieces in
  79. place and makes the field manager work as expected, and thus you can
  80. search as expected too.
  81. * Make linter happy
  82. [Yajo]
  83. 11.0.1.0.0 (2018-07-20)
  84. ~~~~~~~~~~~~~~~~~~~~~~~
  85. * Rename, refactor, migrate to v11
  86. [Yajo]
  87. Bug Tracker
  88. ===========
  89. Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
  90. In case of trouble, please check there if your issue has already been reported.
  91. If you spotted it first, help us smashing it by providing a detailed and welcomed
  92. `feedback <https://github.com/OCA/web/issues/new?body=module:%20web_advanced_search%0Aversion:%2011.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  93. Do not contact contributors directly about support or help with technical issues.
  94. Credits
  95. =======
  96. Authors
  97. ~~~~~~~
  98. * Therp BV
  99. * Tecnativa
  100. Contributors
  101. ~~~~~~~~~~~~
  102. * Holger Brunn <hbrunn@therp.nl>
  103. * Vicent Cubells <vicent.cubells@tecnativa.com>
  104. * Jairo Llopis <jairo.llopis@tecnativa.com>
  105. * Rami Alwafaie <rami.alwafaie@initos.com>
  106. * Jose Mª Bernet <josemaria.bernet@guadaltech.es>
  107. * Simone Orsi <simone.orsi@camptocamp.com>
  108. Maintainers
  109. ~~~~~~~~~~~
  110. This module is maintained by the OCA.
  111. .. image:: https://odoo-community.org/logo.png
  112. :alt: Odoo Community Association
  113. :target: https://odoo-community.org
  114. OCA, or the Odoo Community Association, is a nonprofit organization whose
  115. mission is to support the collaborative development of Odoo features and
  116. promote its widespread use.
  117. This module is part of the `OCA/web <https://github.com/OCA/web/tree/11.0/web_advanced_search>`_ project on GitHub.
  118. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.