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.

82 lines
2.6 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. 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 smashing it by providing a 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. Maintainer
  49. ----------
  50. .. image:: https://odoo-community.org/logo.png
  51. :alt: Odoo Community Association
  52. :target: https://odoo-community.org
  53. This module is maintained by the OCA.
  54. OCA, or the Odoo Community Association, is a nonprofit organization whose
  55. mission is to support the collaborative development of Odoo features and
  56. promote its widespread use.
  57. To contribute to this module, please visit https://odoo-community.org.