Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A role defines a set of permissions for actions and/or objects available for users within Connect and may be applied to objects as well. A role may be assigned to multiple users and multiple objects, however a user can have only one role assigned.

Sections within this topic:

Table of Contents
maxLevel4
indent25px

Anchor
creating-a-role
creating-a-role

Creating a role

To create a role: 

  1. Choose the drop-down arrow to the far right of the menu bar. 

    Expand
    titleClick here to expand...


  2. Choose Edit Users/Roles

    Expand
    titleClick here to expand...


  3. In the Users and Roles window, in the Roles tab, choose Add

    Expand
    titleClick here to expand...


  4. In the Edit Role window, enter the Name of the role you are creating. 

    Expand
    titleClick here to expand...


  5. The Expires date defaults to one year from the current date, however you can edit this date.  When the role expires, the user will no longer have access to Connect.
  6. Under the Permissions section, choose the permissions that users assigned to this role will have. 

    Expand
    titleClick here to expand...


    Note

    If you have several check boxes to mark, choose the Admin check box to mark all of the check boxes and then remove the marks you don't need.


  7. Choose OK.

Anchor
files_working_with_roles_htm_edi_9001
files_working_with_roles_htm_edi_9001
 
Anchor
editing-a-role
editing-a-role

Editing a role

To edit a role:

  1. Choose the drop-down arrow to the far right of the menu bar. 

    Expand
    titleView image


  2. Choose Edit Users/Roles

    Expand
    titleView image


  3. In the Users and Roles window, in the Roles tab, choose a role and then choose Edit

    Expand
    titleView image


  4. In the Edit Role window, you can edit nameexpiration date, and/or permissions

    Expand
    titleView image


  5. Choose OK.

 

Anchor
deleting-a-role
deleting-a-role
Anchor
files_working_with_roles_htm_del_7240
files_working_with_roles_htm_del_7240

Deleting a role

To delete a role:

  1. Choose the drop-down arrow to the far right of the menu bar. 

    Expand
    titleView image


  2. Choose Edit Users/Roles

    Expand
    titleView image


  3. In the Users and Roles window, in the Roles tab, choose a role and then choose Delete. Users assigned to this role will not have log in Connect. 

    Expand
    titleView image


  4. Choose Yes in the confirmation window.
  5. Choose OK.

Anchor
files_working_with_roles_htm_app_2563
files_working_with_roles_htm_app_2563
 
Anchor
applying-a-role-to-an-object
applying-a-role-to-an-object

Applying a role to an object

Roles can be applied to objects to limit a specific set of objects/devices to users who have been assigned to the same role. Users with the Admin role will be able to see all of the objects. Multiple roles may be applied to objects. The  Object role application rules  table indicates if roles may be applied at the top level and the inheritance (if any) to children. 

Expand
titleView image


To apply a role to an object:
 
In this example, a role is applied to a Site.

  1. Choose the Configuration Explorer  icon, and then expand Campuses and then expand the campus name.  
  2. Right-click on the Site name

    Expand
    titleView image


  3. Choose Edit Roles.
  4. In the Object Role Editor, mark/unmark the Can Read and/or Can Edit check boxes next to the roles. 

    Expand
    titleView image


    Note

     Your user role will not be visible.


  5. Choose OK. All Areas beneath this Site will have the same roles applied.
  6. If you apply roles to a level above the Site, a message asks if it is okay to apply the changes to all of the selected objects, which are the children beneath the object that is selected based on the rules defined in the Object role application rules  table.
    • Choose Yes and the children beneath this level will be updated to the roles applied at this level.
    • Choose No to return to the Object Role Editor and then choose Cancel to close the window.

Anchor
object-role-application-rules
object-role-application-rules

Object role application rules

There are different rules for the top-level objects and how (or if) a role affects the object's children. 

Expand
titleView image


Object

Apply to Top-Level

Inheritance to children

Additional information

Agents

Yes

All children

A role applied at any level is applied to children.

AutoReports

No

N/A

Roles cannot be applied to any children.

Campuses (Sites, Areas)

Yes

All children

A role applied at any level is applied to children

Energy

No

Inheritance depth is one level.

A role applied to sub-level 1 is applied to sub-level 2, but not to sub-level 2 children.

Profiles

No

Inheritance depth is one level.

A role applied to sub-level 1 is applied to sub-level 2, but not to sub-level 2 children.

Reports

No

No

Roles may only be applied to reports.

Note

You can apply the role to a folder, but users won't see any reports unless the report also has the role applied.


Watchdogs

No

Inheritance depth is one level.

A role applied to sub-level 1 is also applied to sub-level 2, but not to sub-level 2 children.


Info
iconfalse

Download the Roles training guide.