Workspaces

Prev Next

Learn how to organize Tulip assets for multiple production environments within a single instance.

Who can use this feature

Users on Enterprise plans.

Workspaces are a new feature set in Tulip, allowing organizations to manage users and resources for multiple sites or environments, within a single global Tulip instance.

A Workspace is a partition within a Tulip account with its own set of resources like apps, Machines, and Tables, that are independent of other workspaces within an account. Workspaces can be useful for separating data for different teams or facilities.

Resources like Connectors can be standardized and deployed globally to different sites, while apps and data can be managed locally at each facility.

Workspace Use-Cases

  • Organizing operations by site

    • Boston, Munich, Hungary
  • Organizing team data by department level

  • Organizing data for testing, training, and staging sites for App validation purposes

Prior to Workspaces, these use-cases required a number of instances to be provisioned in order to segregate data but this is now made simpler with only needing to manage one instance that houses multiple workspaces.

Workspaces Page

To find the Workspaces page, click your user icon in the top right corner. Select Account Settings then click the Workspaces tab on the left navigation bar.

Workspaces Page.gif

Configuration

With the addition of Workspaces, you have access to assign a new user role: Workspace Owner. This user role has all Account Owner permissions, but restricted to their assigned Workspace. All other user roles/permissions remain unchanged.

Learn more about user roles here.

An Account Owner can specify which Workspace a user has access to by navigating to the Account Settings and then to the Users page.

SAML and LDAP functionality remains unchanged. For SAML, Account Owners will have the ability to specify a Workspace mapping from their IdP. This will be used to set the initial Workspace for a user. A default Workspace can also be defined for all new users.

Resources

Here is the breakdown of resource sharing at the Account and Workspace level:

Account Scoped Workspace Scoped
Connectors Stations
Connector Functions Apps
Machine Types Analytics
Machine Data Sources Tables
Edge Devices Machines
IP Cameras Cameras
Camera Detectors User Table*

*With Workspaces enabled, the User Table is scoped to users defined within the Workspace. Global roles (Account Owners) are not included in the User Table for an individual Workspace, which may impact the ability to run app logic that involves reading or writing to the User Table.

Settings

With Workspaces enabled, here is a breakdown of the Account and Workspace scoped settings that can be adjusted by Account Owners at the account level and Workspace Owners at the Workspace level:

Account Settings Workspace Settings
Account Workspace
Users Users
Player Date and Time - Time Zone
Date and Time - Format only Schedules and Shifts
Color Palette Device Uptime
Developer Mode Approvals
Network Access API Tokens

Add users to multiple workspaces

In the App editor, you can navigate across Workspaces using the dropdown menu in the top left of the page from Workspace scoped pages.

Global Roles
Account Owners have the ability to navigate across workspaces within an Instance.

Workspace-Scoped Roles
Users can be a part of multiple workspaces, with a separate role in each workspace.

Once you add a user to multiple workpsaces, they will be able to choose from the list of workspaces where they have a role, as shown above.

Add/archive/rename a workspace

Account Owners can create new workspaces, as well as rename, archive, and un-archive workspaces. To access these abilities, go the the Workspaces page under Account Settings.

NOTE

You cannot archive workspaces that use the Enterprise App Exchange. You must first disable this feature from your workspace.

Move apps across workspaces

The App Import/Export functionality remains unchanged across Workspaces within the same instance.

Further Reading