How do I add other owners/members to my site?

Site owners

By default, you are a Site Owner of any Sites you create. You can add other owners/users, which will grant them the FULL ADMIN access to the site. Full admin access grants the users the ability to see and modify all settings. It gives access to all pages in the cloud ui, and access to all zencontrol mobile applications. This is unrestricted access and should only be given to a few privileged users. For normal users, where you would like to control their access, please add the user as a site member or tenancy member instead.

1. Locate the Site on the Sites page.
2. Click its thumbnail to visit its Dashboard.
3. Click the Settings/Site Details link (represented by a gear icon) to change Site Settings.
   
   
   
4. There will be a number of tabs across the top of this page. Click the Site Owners tab.
   You will be shown a list of all the users with Owner access to the Site, including yourself.
   
5. Click the Add Users row on this page (it will be the last row and may requires scrolling to the bottom). A dialog will appear.
6. Use the search field in the Add owners dialog to choose the user you want to add.
   You may search by the user's name, company or email (must match exactly). There is no need to click, or press Enter: the search results appear automatically, if successful.
7. Select the users you want to add, and they will be highlighted.
   
8. Click the green Add Owners button at the bottom of the dialog. 
   The dialog will disappear and the newly-granted owners will appear in the Site Owners list.
   IMPORTANT: The users will not be added until the save button is pressed.
   You may add multiple users to the site before clicking save.
9. Click Save to apply changes.
   

To remove a user from a Site, the process is similar, except instead of clicking Add Users, you must click the cross icon in the Site Owners list and confirming the action. You may even remove yourself from a Site as long as you are not the last remaining user with access to that site.

Warning: If you remove yourself from this list, you will lose access to the Site.

Site members

If you don't want to give a user full access to your site then you can make them a site member instead. This will give you the ability to fine tune the user's permissions and feature visibilities. Adding a site member is almost the same as adding a site owner except there are two dropdowns that will dictate what permissions and feature visibilities the user will get when they are granted to your site. These can be changed after adding the user as well.

1. Open the site details page, and navigate to the site members tab.
   
2. Click the Add Users row on this page (it will be the last row and may requires scrolling to the bottom). A dialog will appear.
3. Select the user's permissions by using the 'level of access to add' dropdown, as well as the feature visibilities for the user. Use the search field in the Add Members dialog to choose the user you want to add. You may search by the user's name, company or email (must match exactly). There is no need to click, or press Enter: the search results appear automatically, if successful.
   
4. Click the green Add members button at the bottom of the dialog. The dialog will disappear and the newly-granted owners will appear in the Site Members list.
   IMPORTANT: The users will not be added until the save button is pressed.
   You may add multiple users to the site before clicking save.
5. Click Save to apply changes.

After adding a member to your site, you will see them in the list. You can edit their user type, permissions and feature visibilities by clicking on the row for that user.  Clicking the pencil icon will bring up a dialog where you can change each setting.

Access to certain parts of the site

If you want to give the user more access to certain parts of your site you can click on the bottom row, select what part of the site you want to grant them access to and what level of access you want to give them. This means you can give them access to only certain control systems, device locations etc. without giving them access to the entirety of the site. A new row will appear for each explicit access that you give to the user. They can be removed by clicking the trash can icon.

For example, if you wish to give a user read access to only a single control system on the site.

1. Open the users permissions by clicking on their row in the site members tab.
2. Change the site permission to limited tenancy access (this gives the user a small subset of read permissions to floors, profiles and sites required to use most of the cloud ui)
3. Click the plus icon at the bottom, and select control system from the first dropdown. Then select the control system you would like to grant access to (eg. chris desk), and the permissions you would like to give. Click the select button to add the permission. IMPORTANT: The users permissions will not be modified until the save button is pressed.
4. Click back and save to apply changes.

Tenancy members

Tenancy owners and members can be added and edited from the tenancy management ui. This is a simplified view that can be used to quickly assign a user to tenancy. Tenancy owners are similar to site owners, they get full access to all of the tenancy. Tenancy members permissions and feature visibilities can be quickly edited by selecting them in the table.

For more advanced tenancy permissions please use the site members ui and select tenancy from the user type dropdown.

Feature Visibility

Feature visibility controls what pages the user can see in the cloud and certain access to mobile applications. They can be configured for site or tenancy members. This is useful for stopping a user from accessing certain pages or features.

Note:  If a user has write access to something, they can do it through any ui that supports it. ie. disabling grid-view will only stop a user configuring settings from the grid-view page. They can still configure these settings through plan view commissioning if they have that feature visibility, or even through the app if they that. The best way to restrict access if through user's permissions, as this will stop them from being able to change the setting from any ui.

Common options can be configured by selecting from the dropdown.

More advanced options, and the ability to see what each of the common options cover, can be done by going into expert mode, and expanding the collapsed section. 

Each of the feature visibilities controls access to the sidebar tabs on the left of the screen, disabling the feature visibility will prevent the user from navigating to that page (or app feature).

For example a user with the following visibility 

will only see limited options (note: only plan view and issues are enabled)

Options are as follows:

User Permissions

Common options for user permissions can be selected from the dropdowns at each level. 

The common options are as follows.

To view what each permission covers please go into expert mode. For example, a user with limited tenancy Access only has the ability to

• view properties on the site
• view site profile crons (note: they cannot see tenancy crons, crons that are just for a tenancy)
• view profiles
• view floors
• view fitting types

Fine tuning permissions

If you need to fine tune a user's access even further then you can enable Expert mode from the top of this window. You will notice arrows to the right of the rows appear which indicate that the row can be expanded to edit permissions even further.

Expanding each row will display all of the possible permission options. Some will not be able to be edited because they will be applied as part of the template. Editing a permission will remove the permissions that cannot be edited as they will no longer be applied as you will be applying custom permissions for the user.

In most cases you will not need to tinker with expert mode but the option is there for the small number of cases where you need to give a user specific permissions to particular things on the site rather than just blanket permissions on the site or a tenancy on the site.

User Type

Users can be either site or tenancy users. If a user is added through the tenancy management ui they will normally be a tenancy member. By default only site members are show in the site members ui. To see tenancy users select the 'Tenancy user' option. The permissions for that user can than be managed in the same way a site users permissions are managed.