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.

85 lines
2.7 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  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. You can also define default roles for a new user by editing the user called
  29. "Default User".
  30. Roles:
  31. .. image:: /base_user_role/static/description/roles.png
  32. Add groups:
  33. .. image:: /base_user_role/static/description/role_groups.png
  34. Add users (with dates or not):
  35. .. image:: /base_user_role/static/description/role_users.png
  36. Bug Tracker
  37. ===========
  38. Bugs are tracked on `GitHub Issues
  39. <https://github.com/OCA/server-tools/issues>`_. In case of trouble, please
  40. check there if your issue has already been reported. If you spotted it first,
  41. help us smashing it by providing a detailed and welcomed feedback.
  42. Credits
  43. =======
  44. Images
  45. ------
  46. * Oxygen Team: `Icon <http://www.iconarchive.com/show/oxygen-icons-by-oxygen-icons.org/Actions-user-group-new-icon.html>`_ (LGPL)
  47. Contributors
  48. ------------
  49. * Sébastien Alix <sebastien.alix@osiell.com>
  50. Maintainer
  51. ----------
  52. .. image:: https://odoo-community.org/logo.png
  53. :alt: Odoo Community Association
  54. :target: https://odoo-community.org
  55. This module is maintained by the OCA.
  56. OCA, or the Odoo Community Association, is a nonprofit organization whose
  57. mission is to support the collaborative development of Odoo features and
  58. promote its widespread use.
  59. To contribute to this module, please visit https://odoo-community.org.