/
Roles and Profiles

Roles and Profiles

Difficulty: expert

Learning Objectives

After reading this article, you’ll be able to:

  • Understand Roles/Profiles set-up in Workplace

  • Select relevant roles per Workplace user

  • Create environment specific roles as per your needs


Roles and Profiles can be used to differentiate users, their rights and options in Workplace.

If a user has multiple roles assigned to him/her, the overall scope of the user will be the sum total/union of all individual roles.

 

How to access:

  • Go to Workplace back-end Studio

  • Login with your credentials

  • Select Users & Roles > Roles

image-20240116-175042.png

 

The user permissions are stored in the session cache and refreshed every 15 minutes or upon re-login.
This means that changes to Roles & Permissions are applied after re-login, or when the user closes the tab (or the complete browser), waits for 15+ minutes, and re-opens the portal again.

Standard Roles

Every Workplace user is created with Default role. Either manually or through excel upload, any other role can immediately be assigned to a user.

 

  • Default” role

    • The default role has a set of default permissions. Admins can manage the permissions of this default role.

      • Usually, end-users can see real-time data and can make & edit reservations

    • It's not possible to remove this role 

Following permissions are configured for Default role

Feature in GO

Following permissions are configured for Default role

Feature in GO

livedata.view

Live Data > View Room details

reservations.view 

Live Data > Create a reservation

reservations.view

My Reservations

replay.view 

Replay

reports.view

Dashboards

kiosk.view 

Kiosk mode

locationcharts.view

View historical sensor data in location detail view

Following permissions are usually added to Default role (or another one)

Feature in GO

Following permissions are usually added to Default role (or another one)

Feature in GO

colleague.find

Find a Colleague

 

  • Admin” role is needed to access Studio (will only give access to current environment) and Device Control (for KioskApp and Workplace App)

! With great power comes great responsibility: make sure the Admin-user is aware of the Studio basics. Having access to Studio means being able to configure general Settings, Sensor Devices, User Management, Floor plan configuration etc => a basic training in Studio is needed before access can be given.

 

  • “Admin.devices” role only gives access to Studio Spaces and Studio Devices. All other settings are not available. This role is typically assigned to external hardware installation partners, who need access to Studio in regards to creation of devices, but should not be able to modify anything else.

  • “Reporter” role allows access to Dashboards

  • “Developer" role is typically assigned to users who have the rights to view/consume/integrate Workplace Rest API . These users might be external developers who work on integrating Workplace with their systems, and should not have access to Workplace touchpoints.

  • “Contentcontributor” role is required to create a Content Library (set up Custom Content)

  • “Contentadmin” role is required to publish/manage Custom Content

Environment Specific Roles

Depending on the needs in your environment, other roles can be added to the environment (select "Add New"), for example access to dashboards on Workplace Web (GO) can be restricted for a specific role.

Below listed Permissions list what is possible.

Role based reservation scope definition

Create a Workplace Role which restricts the user to see only a limited scope of locations, and to be able to make reservations only in those locations.

Step 1: Role definition

Add new role of Type "Reservation Restriction", and describe the reservation scope of a user by using any of the following 3 parameters:

  • location type

  • location scope

  • zone scope

image-20240116-175645.png

 

Location Type - Each role can be defined for either

  • only rooms

  • only workplaces

  • only parking places

  • a combination of the above

Locations scope (buildings) - The locations in which the user is allowed to book a room or desk.

Zone scope - Rooms and workplaces can be linked to zones in Workplace under the Location Grouping settings. When a set of zones are enabled in a role, the user can only book rooms/workplaces linked to that zone.

 

 

 

Users that have this role assigned

  • should only be able to make reservations on Workplaces, in all locations

  • should not be able to make reservations on Rooms nor Parking spaces (anywhere)

 

  1. Select “Add New Role”

  2. Fill in a Name and Description for the Role

  3. Select Role Type “Reservation Restriction”

  4. Select Space Type “Workplace”

Users that have this role assigned

  • should only be able to make reservations on Rooms, Workplaces and Parking spaces in 1 specific location

  • should not be able to make reservations on Rooms, Workplaces and Parking spaces in any of the other locations

 

  1. Select “Add New Role”

  2. Fill in a Name and Description for the Role

  3. Select Role Type “Reservation Restriction”

  4. Select Space Type “Room”

    1. Select the specific location

  5. Select Space Type “Workplace”

    1. Select the specific location

  6. Select Space Type “Parking”

    1. Select the specific location

Users that have this role assigned

  • should only be able to make reservations on

    • Rooms in 1 specific location, and

    • workplaces that are linked to a specific zone or location groups in that same location

  • should not be able to make reservations on

    • workplaces that are linked to none or other zones/location groups in that same location

    • Rooms, Workplaces and Parking spaces in any of the other locations

 

  1. Select “Add New Role”

  2. Fill in a Name and Description for the Role

  3. Select Role Type “Reservation Restriction”

  4. Select Space Type “Room”

    1. Select the specific location

  5. Select Space Type “Workplace”

    1. Select the specific location

    2. Select the zone that workplaces need to belong to, before the user can book them

In this example, we’ll be combining 2 Reservation Restriction Roles, that each in itself can be assigned.

 

Users that have these roles assigned

  • should only be able to make reservations on

    • Rooms in 2 specific locations, that are linked to specific zones or location groups in those same locations

    • Workplaces in the same 2 locations, and in 1 additional location

  • should not be able to make reservations on

    • Rooms that are linked to none or other zones/location groups in any of those locations

    • Rooms in any of the other locations

    • Workplaces in any of the other locations

    • Parking spaces

 

  1. Select “Add New Role”

  2. Fill in a Name and Description for the Role

  3. Select Role Type “Reservation Restriction”

  4. Select Space Type “Room”

    1. Select the specific locations

    2. Select the zones that rooms need to belong to, before the user can book them

 

  1. Select “Add New Role”

  2. Fill in a Name and Description for the RoleSelect Space Type “Workplace”

    1. Select the specific locations

    2. Select the zone that workplaces need to belong to, before the user can book them

 

 


Step 2: Role assignment

Workplace users are assigned a default role. When users are assigned with another role ABC, this role specific permissions shall be applicable to the users along with ‘Default’ role permissions.

An administrator can assign one or more roles to a user. If a user has multiple roles assigned to him/her, the overall reservation scope of the user will be the sum total/union of all individual roles. See Users and Groups for more information on user creation.


When a Reservation Restricted Role is assigned, the user can only book rooms/workplaces described within the role on Workplace touch points. Reservation requests for other locations will be blocked by Workplace.

Settings in IWMS

Settings in Workplace



Result in IWMS

Result in Workplace

Settings in IWMS

Settings in Workplace



Result in IWMS

Result in Workplace

No restriction / Allowed to book room X

No restriction / Allowed to book room X

->

Allowed to book room X

Allowed to book room X

No restriction / Allowed to book room X

Restriction set on room X

->

Allowed to book room X

Not allowed to book room X

Restriction set on room X

No restriction / Allowed to book room X

->

Not allowed to book room X

Not allowed to book room X


What does this look like for the user?

With Reservation Restrictions set in Workplace, the user will be able to

  • select a location on the live floorplan, which will open the room detail screen, but will

    • not see any availability data

    • not see the capacity information

    • not see the “check availability button” ~so will not be able to

  • use the Create a Booking feature, but the restricted areas will not be part of the search results

 

If a user is trying to book a resource that is outside of his/her reservation scope (set in IWMS), at the end of the reservation workflow, an error message is shown.
For more details please view the debug page.

Permissions

 

Permission

Description

Related to

1

users.impersonate

Impersonate other users at API level (Used by Cobundu)

Other

2

kiosk.view

Use kiosk

GO

3

content.edit

Modify content

Device control

4

reservations.view

User reservation features

GO

5

reservations.confidential.view

View confidential reservations

GO

6

sensordata.export

Export raw sensor data

GO

7

reports.view

View reports

GO

8

users.edit

Modify users

Studio

9

livedata.view

View life data

GO

10

rest.view

View the REST API browser

GO

11

settings.edit

Modify global settings and connect to other systems

Studio

12

devices.edit

Modify devices (sensor, tag,…)

Studio

13

roles.edit

Modify roles & profiles

Studio

14

settings.saml

Modify SAML settings

Studio

15

colleague.find

Find a colleague

GO

16

kiosks.edit

Modify kiosks

Studio

17

contentrules.edit

Modify content rules

Studio

18

plans.edit

Modify plans

Studio

19

replay.view

Use replay

GO

20

locationcharts.view

View historical sensor data in location detail view

GO

21

pulsecount.edit

Reset Pulse Count per location (and decide to create ticket), see View By Other Pulse Count

GO

22

calendar.view

Use calendar features

GO

23

visitors.manage

Enables visitor management

GO

24

costcenter.mandatory

Make Cost Center selection mandatory for Services & Equipment reservation

GO

25

reservations.recurring

Use recurring reservations

GO

 


 

Search

Search