Workspaces

March 1, 2021

Workspaces allow partitioning of a single server into multiple compartments that have limited impact on each other.

The following are the rules guiding the use and functioning of the workspaces:

  1. An administrator has access to all workspaces.
  2. A user with an HQ and observer accounts may belong to one, some, or all workspaces, as designated by the administrator.
  3. Each interviewer and supervisor account may log in to a single workspace.
  4. User names are unique across all workspaces.
  5. Questionnaires are imported into workspaces. Same questionnaire may be imported into different workspaces if necessary and their version numbering is independent.
  6. Workspaces may be created, disabled, and deleted.
  7. Disabling a workspace locks all activity in the workspace (stops web interviews, does not allow any user to log in). Users attempting to access a disabled workspace will receive a “Workspace Disabled” error page and must contact their survey coordinator for further instructions.
  8. A workspace may be deleted only if it doesn’t have any surveys/questionnaires.
  9. Deleting a workspace actually deletes (not archives) all the user accounts (interviewer/ supervisor) and all the maps that were part of that workspace.
  10. Deletion of a workspace is irreversible.
  11. Administrator configures each workspace settings separately (logo, global message, export password, email providers, etc).
  12. The troubleshooting tools available for administrator (audit log, device logs, tablet information packages, etc) are separated by workspaces.
  13. Users having access to multiple workspaces may switch between them using a workspace selector without the need to log in to each workspace separately.
  14. Reports are built based on the content of a single workspace.
  15. A special workspace named ‘primary’ is always defined and can not be disabled or deleted. Any server updated from earlier Survey Solutions versions will place all the earlier entered data (including survey data, user accounts, maps, etc) into the primary workspace.
  16. An observer may observe only in the workspaces in which he is permitted by the administrator, even if impersonating users that have access to other workspaces.
  17. Each workspace is assigned an identifier and a text label. The text label is shown to the users when they switch between the workspaces, while the identifier is used for forming the URLs in API calls.

To manage workspaces, the menu item server administration (available for administrators only) now leads to the list of the workspaces defined on the server. The settings and troubleshooting tools collected in the context menu were previously relevant for the whole server, but now are attributable to a particular workspace. For each enabled workspace the following actions are provided in the workspace context menu:

  • Edit,
  • Settings,
  • Email providers,
  • Device logs,
  • Audit log,
  • Tablet information packages,
  • Disable*
  • Delete*

*) The actions to disable and delete a workspace do not apply to the primary workspace.

Disabled workspaces may only be turned back on or deleted, so their context menu is smaller:

  • Enable
  • Delete

List of users on the server

Users on the server are distinguished by the accounts and the full list of all accounts on the server is available by accessing the Server administration –> Users Management page.

The list supports filtering by workspace and role of the user, as well as narrowing down the users to a particular group:

  • ‘missing workspaces’ - users not assigned to any workspace.
  • ‘with disabled workspaces only’ - users that don’t have access to any enabled workspace.
  • ‘locked users’ - users with an account lock placed on them.
  • ‘archived users’ - users that have been archived.

A search box allows to seek the list for a user with a particular account name or a full name.