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.

83 lines
2.6 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: https://www.gnu.org/licenses/agpl
  3. :alt: License: AGPL-3
  4. ==========
  5. User roles
  6. ==========
  7. This module was written to extend the standard functionality regarding users
  8. and groups management.
  9. It helps creating well-defined user roles and associating them to users.
  10. It can become very hard to maintain a large number of user profiles over time,
  11. juggling with many technical groups. For this purpose, this module will help
  12. you to:
  13. * define functional roles by aggregating low-level groups,
  14. * set user accounts with the predefined roles (roles are cumulative),
  15. * update groups of all relevant user accounts (all at once),
  16. * ensure that user accounts will have the groups defined in their roles
  17. (nothing more, nothing less). In other words, you can not set groups
  18. manually on a user as long as there is roles configured on it,
  19. * activate/deactivate roles depending on the date (useful to plan holidays, etc)
  20. * get a quick overview of roles and the related user accounts.
  21. That way you make clear the different responsabilities within a company, and
  22. are able to add and update user accounts in a scalable and reliable way.
  23. Configuration
  24. =============
  25. To configure this module, you need to go to *Configuration / Users / Roles*,
  26. and create a new role. From there, you can add groups to compose your role,
  27. and then associate users to it.
  28. Roles:
  29. .. image:: /base_user_role/static/description/roles.png
  30. Add groups:
  31. .. image:: /base_user_role/static/description/role_groups.png
  32. Add users (with dates or not):
  33. .. image:: /base_user_role/static/description/role_users.png
  34. Bug Tracker
  35. ===========
  36. Bugs are tracked on `GitHub Issues
  37. <https://github.com/OCA/server-tools/issues>`_. In case of trouble, please
  38. check there if your issue has already been reported. If you spotted it first,
  39. help us smash it by providing detailed and welcomed feedback.
  40. Credits
  41. =======
  42. Images
  43. ------
  44. * Oxygen Team: `Icon <http://www.iconarchive.com/show/oxygen-icons-by-oxygen-icons.org/Actions-user-group-new-icon.html>`_ (LGPL)
  45. Contributors
  46. ------------
  47. * Sébastien Alix <sebastien.alix@osiell.com>
  48. * Duc, Dao Dong <duc.dd@komit-consulting.com> (https://komit-consulting.com)
  49. Maintainer
  50. ----------
  51. .. image:: https://odoo-community.org/logo.png
  52. :alt: Odoo Community Association
  53. :target: https://odoo-community.org
  54. This module is maintained by the OCA.
  55. OCA, or the Odoo Community Association, is a nonprofit organization whose
  56. mission is to support the collaborative development of Odoo features and
  57. promote its widespread use.
  58. To contribute to this module, please visit https://odoo-community.org.