About your Workspace
Workspaces are hosted private collaborative analytic environments within the platform, which a distributed team can access through both their web browser and virtual machine environments.
The core principles of a workspace are:
- Workspaces are private to their members.
- User access to workspace features and data is managed through a permissions model and can be maintained by a Workspace Administrator.
- Workspaces are configured based on file and database storage and compute requirements, virtual machine requirements, and any additional add-on services (such as the R Shiny server).
- Users manage their data in their workspace including modelling, cleansing, filtering and sharing.
- Workspaces allow you to manage core data assets such as database files and tables, documents and scripts.
- Once uploaded, files, database and data files are readable and writable via both the web interface and the optional virtual machine environment.
- Workspaces provide audit reporting.
Workspace Quickstart Guide
Navigating your Workspace
Upon logging in and entering a workspace, you arrive at the workspace Home page. Several fixed tabs are visible from this page:
This tab shows the dedicated workspace homepage if one has been configured. This can be done by supplying HTML in a workspace.html file in the Files folder.
ActivityThis tab shows a summary of recent activity relating to the workspace – for example when files have been uploaded or deleted. When on this page you can add notes, comments, and insights about any events in the workspace.
FilesThe Files tab shows all of the files associated with the workspace. These can be images, text documents, PDFs, SQL or R scripts and custom files.
DatabaseThe Database tab shows a list of the database tables and custom views that are available in the workspace database.
ToolsThe Tools tab provides links to the:
- R console (pre-configured with a broad selection of the most popular packages and can be further customised by the user to include any of the 5000+ packages that have been built by the R user community).
- Built-in applications: (RStudio and Jupyter Notebook)
- Virtual machines: where you can start, stop, and connect to whatever Windows or Linux virtual machines you may have access to in your workspace.
This tab shows not only the built-in apps, but also published Shiny apps. You can run your Shiny apps here, explore their file structure and add new files. You can also remove Shiny apps from the gallery here.
UploadThis tab gives you a quick way of uploading files and data, as well as generating and managing upload tokens for the workspace API.
AdministerThis tab is available to workspace members with the role of Workspace Administrator. It gives access to the workspace Audit, which shows all of the auditable events which have occurred in the workspace. These events include the user who has accessed the workspace and files being added or deleted. Additionally, some charts are shown which give a summary of different types of usage of the workspace over time. It also allows Administrators to edit workspace details and manage workspace users.
Browser Support for Workspaces
The following browsers are supported in the current release of Workspaces:
- Google® Chrome
(latest version) - Microsoft® Edge
You may find that you are able to access Workspaces using other browsers such as Firefox or Safari, however, these are not officially supported or used during testing.
Shared Compute Resources in Workspaces
There are certain tools and apps within a workspace that run on compute resources that are shared across the entire hub. They are the Apps (like the Built-in Apps RStudio and Jupyter Notebooks), Shiny Apps, Data Table Analytics modules, and the R console. See more about Workspace tools here.
User Roles
Currently, workspaces support the following user roles: Standard User, Workspace Administrator, Manager, Contributor, and Tenant Administrator. It should be noted that roles are assigned on a workspace basis, meaning a user can have a Contributor role in one workspace and be a Workspace Administrator of the other.
Summary of the roles
- Standard Users can use most of the functionality of the workspace but they do not have the permissions to manage workspace access.
- Workspace Administrators have the same privileges as Standard Users but additionally, they are also responsible for workspace user management. Workspace Administrators can invite new members to a workspace, and assign appropriate user roles.
- Managers have the all the same privileges as Workspace Administrators but one: they cannot approve or reject Airlock requests.
- Contributors have no access to the workspace via the UI. Workspace Contributors can only Airlock files to the workspace they are a Contributor of.
- Tenant Administrators are responsible for the creation and deletion of workspaces, as well as inviting members to a workspace, assigning them user roles, and appointing an owner for each workspace.
Further details on each user role can be found below and in the relevant knowledge base articles in this section.
Role-based privileges
| Administrator | Manager | Standard User | Contributor | Tenant Administrator | |
|---|---|---|---|---|---|
| Create and delete files |  |
|
|
 |
|
| Access and edit database tables | |
|
|
|
|
| Workspace-to-workspace Airlock | |
|
|
|
|
| Approve or reject data export requests | |
|
|
|
|
| Use R console | |
|
|
|
|
| Publish, run and delete Shiny-apps | |
|
|
|
|
| Use Virtual Machine | |
|
|
|
|
| Create, edit and delete notes and insights | |
|
|
|
|
| View list of workspaces that they have been granted access to | |
|
|
|
|
| Access workspace audit | |
|
|
|
|
| Manage workspace access | |
|
|
|
|
| Edit workspace description | |
|
|
|
|
| Add or delete workspaces | |
|
|
|
|
Updated October 16, 2023