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.

102 lines
4.4 KiB

  1. Relation Types
  2. ~~~~~~~~~~~~~~
  3. Before being able to use relations, you'll have define some first.
  4. Do that in Contacts / Relations / Partner relations.
  5. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_list.png
  6. A relation type has a name for both sides.
  7. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_form_empty.png
  8. To have an assistant-relation, you would name one side 'is assistant of' and the other side 'has assistant'.
  9. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_form_name_filled.png
  10. Partner Types
  11. ~~~~~~~~~~~~~
  12. The `Partner Type` fields allow to constrain what type of partners can be used
  13. on the left and right sides of the relation.
  14. * In the example above, the assistant-relation only makes sense between people, so you would choose 'Person' for both partner types.
  15. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_form_partner_type_filled.png
  16. * For a relation 'is a competitor of', both sides would be companies.
  17. * A relation 'has worked for' should have persons on the left side and companies on the right side.
  18. If you leave these fields empty, the relation is applicable to all types of partners.
  19. Partner Categories
  20. ~~~~~~~~~~~~~~~~~~
  21. You may use categories (tags) to further specify the type of partners.
  22. You could for example enforce the 'is member of' relation to accept only companies with the label 'Organization' on the right side.
  23. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_form_category_filled.png
  24. Reflexive
  25. ~~~~~~~~~
  26. A reflexive relation type allows a partner to be in relation with himself.
  27. For example, the CEO of a company could be his own manager.
  28. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_reflexive.png
  29. Symmetric
  30. ~~~~~~~~~
  31. A symetric relation has the same value for the left and right sides.
  32. For example, in a competitor relation, both companies are competitors of each other.
  33. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_symmetric.png
  34. Invalid Relation Handling
  35. ~~~~~~~~~~~~~~~~~~~~~~~~~
  36. When the configuration of a relation type changes, some relations between 2 partners may become invalid.
  37. For example, if the left partner type is set to `Person` and a relation already exists with a company on the right side,
  38. that relation becomes invalid.
  39. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/relation_type_invalid_handling.png
  40. What happens with invalid relations is customizable on the relation type.
  41. 4 possible behaviors are available:
  42. * Do not allow change that will result in invalid relations
  43. * Allow existing relations that do not fit changed conditions
  44. * End relations per today, if they do not fit changed conditions
  45. * Delete relations that do not fit changed conditions
  46. Searching Partners With Relations
  47. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48. To search for existing relations, go to `Contacts / Relations / Relations`.
  49. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/search_relation.png
  50. To find all assistants in your database, fill in 'assistant' and
  51. autocomplete will propose to search for this type of relation.
  52. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/search_relation_2.png
  53. Now if you want to find Colleen's assistant, you fill in 'Colleen' and one of the proposals
  54. is to search for partners having a relation with Colleen.
  55. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/search_relation_3.png
  56. Searching Relations From Partner View
  57. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58. A smart button is available on the partner form view to display the list of relations.
  59. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/partner_form_view_smart_button.png
  60. .. image:: https://raw.githubusercontent.com/OCA/partner-contact/12.0/partner_multi_relation/static/description/partner_form_view_smart_button_2.png