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.

79 lines
2.2 KiB

  1. =================
  2. Partner Revisions
  3. =================
  4. Configuration
  5. =============
  6. Access Rights
  7. -------------
  8. The revisions rules must be edited by users with the group ``Revision
  9. Configuration``. The revisions can be applied or canceled only by users
  10. with the group ``Revisions Validations``
  11. Revision Rules
  12. --------------
  13. The revision rules can be configured in ``Sales > Configuration >
  14. Partner Revisions > Revision Fields Rules``. For each partner field, an
  15. action can be defined:
  16. * Auto: the changes made on this field are always applied
  17. * Validate: the changes made on this field must be manually confirmed by
  18. a 'Revision User' user
  19. * Never: the changes made on this field are always refused
  20. In any case, all the changes made by the users are always applied
  21. directly on the users, but a 'validated' revision is created for the
  22. history.
  23. The supported fields are:
  24. * Char
  25. * Text
  26. * Date
  27. * Datetime
  28. * Integer
  29. * Float
  30. * Boolean
  31. * Many2one
  32. Usage
  33. =====
  34. General case
  35. ------------
  36. When users modify the partners, new 'validated' revisions are created so
  37. there is nothing to do. Addons wanting to create revisions which need a
  38. validation should pass the key ``__revision_rules`` in the context when
  39. they write on the partner.
  40. Finding changesets
  41. ------------------
  42. A menu shows all the changesets in ``Sales > Configuration > Partner
  43. Revisions > Partner Revision``.
  44. However, it is more convenient to access them directly from the
  45. partners. Pending revisions can be accessed directly from the top right
  46. of the partners' view. A new filter on the partners shows the partners
  47. having at least one pending revision.
  48. Handling changesets
  49. -------------------
  50. A revision shows the list of the changes made on a partner. Some of the
  51. changes may be 'Pending', some 'Accepted' or 'Rejected' according to the
  52. revision rules. The only changes that need an action from the user are
  53. 'Pending' changes. When a change is accepted, the value is written on
  54. the user.
  55. The changes view shows the name of the partner's field, the Origin value
  56. and the New value alongside the state of the change. By clicking on the
  57. change in some cases a more detailed view is displayed, for instance,
  58. links for relations can be clicked on.
  59. A button on a changeset allows to apply or reject all the changes at
  60. once.