Managed Dashboards UI: managing users access to a dashboard

Purpose:

With managed dashboard functionality it will be possible to add users to a dashboard with either view, edit or manage access level (view = view, edit = ability to modify widgets/widget definitions, manage = ability to add/remove user access to dashboard)

The UI needs to support:

• Viewing list of users with access
• Adding users to dashboard
  • Add user option, pop-up users search, select user
• Changing users' access levels for the dashboard (view/edit/manage)
• Removing users from a dashboard

User story statement(s):

As a dashboard manager
I want to give other users access to a shared dashboard
so that they can view, edit or manage the dashboard

Scenarios: Open "User access" pane

1. Scenario:
   • Given a dashboard
   • When I view the dashboard Actions menu
   • Then I see the option "User access"
2. Scenario:
   • Given the User access option
   • When I select this option
   • Then I see the User access UI
3. Scenario:
   • Given the User access UI
   • When I view the UI
   • Then I see a list of users with access to the dashboard, with the fields:
     • User - displayed as family name, given name with a link to the record in the "Users" app
     • Status from the User record
     • Email from the User record
     • Access level (View, Edit or Manage)
   • And the list is sorted by User A-Z
     
4. Scenario:
   • Given the User access UI AND I am a manager of that dashboard
   • When I view the list of users with access to the dashboard
   • Then I see the option to change the access level for each user (view, edit, manage)
   • And I see options to "Save & close" (instead of "Close") and "Cancel"
     
5. Scenario:
   • Given the User access UI
   • When I view the list of users
   • Then I see my name and details
     • And there is no option to remove the user
     • And there is no option to change my access level
       

Scenarios: Add user

1. Scenario:
   • Given the User access UI AND I am a manager of that dashboard
   • When I view the UI
   • Then I see an option to add a user to the dashboard
2. Scenario:
   • Given the "Add user" option
   • When I select the option
   • Then the User search plugin is displayed
   • And the users displayed have a status of "Active"
3. Scenario:
   • Given the User search plugin
   • When I select a user
   • Then that user is added to the top of the list of users on the "User access" page
     • And a "New" badge is displayed to the right of the user name (note that the New badge is only displayed during the current edit session and will not be displayed after the form has been saved).
     • And "Access level" is set to "View" by default
     • And focus is on the "Access level" field for the added user

Scenarios: Remove user

1. Scenario:
   • Given the User access UI AND I am a manager of that dashboard
   • When I view the list of users with access to the dashboard
   • Then I see the option to Remove each user
2. Scenario:
   • Given the option to Remove a user
   • When I hover my mouse over the option
   • Then I see a tooltip with the text Remove user "users-name"
3. Scenario:
   • Given the option to Remove a user
   • When I select the option
   • Then I see a modal message with the header "Remove user - users-name", body text "User users-name will no longer have access to the dashboard. Select Remove user to go ahead." and two buttons: Cancel and Remove user, formatted as shown in the mock-up.
     
4. Scenario:
   • Given the "Remove user" button in the modal
   • When I select the button
   • Then I see the list of users displayed without the removed user
     • And focus is on the next user in the list (the first focusable element for the user, not the Remove option)

Scenarios: manage inactive and deleted users

1. Scenario:
   • Given a user with the status "Inactive" AND I am a manager of that dashboard
   • When I view the list of users
   • Then I see a dismissable warning banner with the text "Warning: user users-name is inactive and should be removed from this dashboard."
     • And I see the Status field in the list formatted as an Warning (icon + "Inactive")
2. Scenario:
   • Given a user whose UUID cannot be matched in the Users app AND I am a manager of that dashboard
   • When I view the User access UI
   • Then I see a dismissable error banner with the text "Error: user UUID cannot be found in the Users app. This could mean that the user has been permanently deleted. If the problem persists the user can be removed from this dashboard."
     • And in the list of users I see the UUID displayed in place of the user's name
     • And in the list of users I see the word "Error" in the "Status" field, formatted as an Error