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.

105 lines
3.5 KiB

  1. .. image:: https://img.shields.io/badge/license-AGPL--3-blue.png
  2. :target: https://www.gnu.org/licenses/agpl
  3. :alt: License: AGPL-3
  4. =================
  5. Partner Relations
  6. =================
  7. This module aims to provide generic means to model relations between partners.
  8. Examples would be 'is sibling of' or 'is friend of', but also 'has contract X
  9. with' or 'is assistant of'. This way, you can encode your knowledge about your
  10. partners directly in your partner list.
  11. Installation
  12. ============
  13. Configuration
  14. =============
  15. Usage
  16. =====
  17. Before being able to use relations, you'll have define some first. Do that in
  18. Contacts / Relations / Partner relations. Here, you need to
  19. name both sides of the relation: To have an assistant-relation, you would name
  20. one side 'is assistant of' and the other side 'has assistant'. This relation
  21. only makes sense between people, so you would choose 'Person' for both partner
  22. types. For the relation 'is a competitor of', both sides would be companies,
  23. while the relation 'has worked for' should have persons on the left side and
  24. companies on the right side. If you leave this field empty, the relation is
  25. applicable to all types of partners.
  26. If you use categories (tags) to further specify the type of partners, you could for
  27. example enforce that the 'is member of' relation can only have companies with
  28. label 'Organization' on the left side.
  29. Now open a partner, click on the 'Relations' smart button and add relations as appropriate.
  30. Searching partners with relations
  31. ---------------------------------
  32. Searching for relations is integrated transparently into the partner search
  33. form. To find all assistants in your database, fill in 'is assistant of' and
  34. autocomplete will propose to search for partners having this relation. Now if
  35. you want to find Anna's assistant, you fill in 'Anna' and one of the proposals
  36. is to search for partners having a relation with Anna. This results in Anna's
  37. assistant(s), as you searched for assistants before.
  38. By default, only active, not expired relations are shown. If you need to find
  39. partners that had some relation at a certain date, fill in that date in the
  40. search box and one of the proposals is to search for relations valid at that
  41. date.
  42. More info
  43. ---------
  44. For further information, please visit:
  45. * https://www.odoo.com/forum/help-1
  46. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  47. :alt: Try me on Runbot
  48. :target: https://runbot.odoo-community.org/runbot/134/11.0
  49. Known issues / Roadmap
  50. ======================
  51. Bug Tracker
  52. ===========
  53. Bugs are tracked on `GitHub Issues
  54. <https://github.com/OCA/partner-contact/issues>`_. In case of trouble, please
  55. check there if your issue has already been reported. If you spotted it first,
  56. help us smash it by providing detailed and welcomed feedback.
  57. Credits
  58. =======
  59. Contributors
  60. ------------
  61. * Holger Brunn <hbrunn@therp.nl>
  62. * Stefan Rijnhart <stefan@therp.nl>
  63. * Ronald Portier <ronald@therp.nl>
  64. * Sandy Carter <sandy.carter@savoirfairelinux.com>
  65. * Bruno Joliveau <bruno.joliveau@savoirfairelinux.com>
  66. * Adriana Ierfino <adriana.ierfino@savoirfairelinux.com>
  67. * Numigi (tm) and all its contributors (https://bit.ly/numigiens)
  68. Maintainer
  69. ----------
  70. .. image:: https://odoo-community.org/logo.png
  71. :alt: Odoo Community Association
  72. :target: https://odoo-community.org
  73. This module is maintained by the OCA.
  74. OCA, or the Odoo Community Association, is a nonprofit organization whose
  75. mission is to support the collaborative development of Odoo features and
  76. promote its widespread use.
  77. To contribute to this module, please visit https://odoo-community.org.