[[start|Back to Table of Contents]]
====== Roles ======
{{::roles.jpg|}}

Roles are bound to each user account. They determine what features and/or pages they are allowed to perform functions on, such as adding, editing, or deleting entries in the system. This page allows you to do role-specific functions:
  - [[navigating_the_portal#logs|View change logs]]
  - [[superadmin_roles#add_role|Add Role]]
  - [[navigating_the_portal#export_list_to_excel|Export the list to a Microsoft Excel spreadsheet]]
  - [[navigating_the_portal#pagination_controls|Browse through the list pages or display a specific amount of entries per page]]
  - [[navigating_the_portal#search|Search roles]]
  - [[navigating_the_portal#sorting|Sort]] the user list by:
    * Name - The name of the role. This populates the "Role" options in the [[superadmin_users#add_user|Add User]] and [[superadmin_users#View_edit_user|View/Edit user]] pages.
    * Permissions - Permissions allowed to the role, in codes.
  - [[superadmin_roles#view_edit_role|View a role]]
  - [[superadmin_roles#view_edit_role|Edit a role]]
\\
\\
----
===== Defined Roles =====
As of March 10, 2021, only seven (7) roles are present in the system with defined permissions:
  * [[superadmin_roles#superadmin|Superadmin]]
  * [[superadmin_roles#helpdesk_officer|Helpdesk Officer]]
  * [[superadmin_roles#level_2_officer|Level 2 Officer]]
  * [[superadmin_roles#level_3_officer|Level 3 Officer]]
  * [[superadmin_roles#gad|GAD]]
  * [[superadmin_roles#project_admin|Project Admin]]
  * [[superadmin_roles#helpdesk_and_level_2_officer|Helpdesk and Level 2 Officer]]
\\
\\

==== Superadmin ====
The Superadmin role has access and permissions to all pages and functions in the GRM Portal. These privileges cannot be altered from this page.
\\
\\


==== Helpdesk Officer ====
The Helpdesk Officer has privileges to the following:
  * Access - Helpdesk Officer
  * Grievances Management
    * Grievances - Create, edit, view, delete
    * Messaging - Message thread, PAP message sending

> A Level 1 GRM receives, logs in, and resolves at most immediate time and level possible, the grievance or complaint filed by the PAP. This will either be at the local level (through Local Help Desks or community-driven platforms such as Tumpukans), or at the “central” (i.e., DOTr) level. Complaints received at Level 1 may be through in-person means (e.g., a local grievance redress office), or through other online channels (mediated through website, social media, SMS technology).
\\
\\

==== Level 2 Officer ====
The Level 2 Officer has privileges to the following:
  * Access - Level 2
  * Grievances Management
    * Grievances - Edit, view
    * Messaging - Message thread

> A Level 2 GRM receives and resolves complaints not resolved at Level 1 and will require dedicated environmental or resettlement-action response by existing Project governance structures (e.g., Local Housing Board, Regional Environmental Management Bureau, etc.)
\\
\\

==== Level 3 Officer ====
The Level 3 Officer has privileges to the following:
  * Access - Level 3
  * Grievances Management
    * Grievances - Edit, view
    * Messaging - Message thread

> A Level 3 GRM receives and resolves complaints not resolved at Level 2.
\\
\\

==== GAD ====
The GAD has privileges to the following:
  * Access - GAD
\\
\\

==== Project Admin ====
The Project Admin has privileges to the following:
  * Access - Project Admin (Sub-admin), Helpdesk Officer, Level 2, Level 3, GAD
  * Grievances Management
    * Grievances - Create, edit, view, delete
    * Messaging - Message thread, PAP message sending
\\
\\

==== Helpdesk and Level 2 Officer ====
The Helpdesk and Level 2 Officer has privileges to the following:
  * Access - Helpdesk Officer, Level 2
  * Grievances Management
    * Grievances - Create, edit, view, delete
    * Messaging - Message thread, PAP message sending
\\
\\


===== Add/Edit Role =====
{{::roleadd.png|}}

Adding or editing a role takes only a few steps:
  - Enter/edit the name of the role in the "Name" field. This is a mandatory field.
  - Choose access level/s in the "Access" section. Multiple access levels are allowed per role.
  - Go to each of the permission sections and subsections and check/uncheck on any of the following, as necessary:
     * Create - If checked, allows the role to add a new entry for that section.
     * Edit - If checked, allows the role to edit any entry in that section.
     * View - If checked, allows the role to view any entry in that section.
     * Delete - If checked, allows the role to delete any entry in that section.
  - Click "Save" to create the new role.
\\
\\

==== Permission Types ====
When adding / editing a role, there are various permission settings that can be allowed to the role being defined. Each permission is tied to a page, and the enabled checkboxes dictate what the user can do in that page under that role.
    * Grievances Management
      * Grievances: Actions allowed in the Grievances page. See: 
        * [[superadmin_grievances|Superadmin: Grievances]]
        * [[helpdesk_grievances|Helpdesk Officer: Grievances]]
        * [[level2_grievances|Level 2 Officer: Grievances]]
        * [[level3_grievances|Level 3 Officer: Grievances]]
        * [[projectadmin_grievances|Project Admin: Grievances]]
        * [[hdl2_grievances|Helpdesk and Level 2 Officer: Grievances]]
      * Messaging
        * Message Thread: Actions allowed in the Journal, Internal Message Thread, and External Message Thread. See: 
          * [[superadmin_using_the_journal_imt_emt|Superadmin: Grievances - Journal]]
          * [[helpdesk_using_the_journal_imt_emt|Helpdesk Officer: Grievances - Journal]]
          * [[level2_using_the_journal_imt_emt|Level 2 Officer: Grievances - Journal]]
          * [[level3_using_the_journal_imt_emt|Level 3 Officer: Grievances - Journal]]
          * [[projectadmin_using_the_journal_imt_emt|Project Admin: Grievances - Journal]]
          * [[hdl2_using_the_journal_imt_emt|Helpdesk and Level 2 Officer: Grievances - Journal]]
        * PAP message sending: Actions allowed in the Notify PAP tab. See: 
          * [[superadmin_notify_pap|Superadmin: Grievances - Notify PAP]]
          * [[helpdesk_notify_pap|Helpdesk Officer: Grievances - Notify PAP]]
          * [[level2_notify_pap|Level 2 Officer: Grievances - Notify PAP]]
          * [[level3_notify_pap|Level 3 Officer: Grievances - Notify PAP]]
          * [[projectadmin_notify_pap|Project Admin: Grievances - Notify PAP]]
          * [[hdl2_notify_pap|Helpdesk and Level 2 Officer: Grievances - Notify PAP]]