Multi-Tenancy (Workspaces)
Last updated
Last updated
Workspaces combine all elements and functions of the Datacake platform in one group.
Devices
Rules and Rule-Engine
Reports
Global Dashboards
Members
You use workspaces to implement the function of multi-tenant capability. Create separate areas in the platform for your customers, distributors, technicians, or other persons, to grant them access to your IoT device's information. The workspace will share access to devices, global dashboards, reports, rules, etc.
When you register on the Datacake platform and create a user account for the first time, a new workspace, with its respective organization is automatically created for you. You can give it a name (which will also be the workspace slug, on the URL). Otherwise, the platform will create a workspace with your name.
To change the current settings of your workspace, navigate to the "Workspace" item using the sidebar. You will be able to change the name of your workspace.
You can setup a workspace logo, which will be shown on top of the navigation, replacing the "Datacake" logo.
The workspace slug is a unique identifier, that also appears on the URL to access to your workspace.
Take into consideration, the "Workspace slug" gets created when you create a workspace. It is based in the workspace's name and it cannot be changed afterwards. Choose the name wisely. You can later change the name of the workspace, but this won't change the slug.
You can delete your workspace, but please take care, this is an irreversible change. You cannot delete your workspace if there are pending subscriptions on it, so you have to firstly cancel all existing subscriptions in the Billing section.
You will now find the SMS log and the Long SMS Mode configuration on your workspace section. This will help you to manage SMS notifications locally using the workspace definition to separate from other tenants.
A single SMS message supports up to 160 characters, or up to 70 if the message contains one or more Unicode characters (such as emoji or Chinese characters). On Long SMS Mode you can choose between these options:
Truncate: The option will cut the content of the SMS to fit the 160 character limit.
Charge: When you send an SMS message containing more than 160 characters, the message is split into smaller messages for transmission. All of those are charged as individual SMS.
If you have more than one workspace, or you have been invited into a workspace by another user, you can switch to other workspaces at any time using the Workspace Selector.
Move your mouse over the workspace's name on the up-left corner, at the top of the sidebar. A pop-up menu opens, which lists all workspaces in which you are a member.
You can search for your workspace's name, or navigate using your keyboard. To switch to another workspace, simply click with the mouse on one of the entries in the list or press "Enter" when navigating with the keyboard.
The Datacake platform allows you to create your own additional workspaces. They can be created within the same "Organization", to allow them to share Billing details, SMS credits, add-ons, white label site configuration, between others. Each workspace will have their own device and members section, independent from other workspaces.
To create another workspace, move your mouse pointer over the Workspace Selector at the top of the left sidebar.
You can then select "Add Workspace". A new modal will open to name your workspace and select its Organization. Activate "Add new workspace to existing organization" to include the workspace inside of an already existing organization. This is recommended when you want workspaces to share billing, SMS credits, add-ons, like the rule engine, and white label configuration.
You can always create a new organization, if you want to keep billing separate.
That's it. Your new workspace is now created and you or your user account has been automatically added to the workspace as a member with all rights.
You can now continue and create your own devices or add already existing devices using the Claiming functionality.
To load additional users into your workspaces, use the sidebar to navigate to the "Members" item under the "Administration" group.
There you will find a list of all members currently in the workspace, as well as the current rights of each member. With the button "Add Member" you can load further persons into your workspace.
More details about these process, how to assign rights, and what effects this has on the person can be found in the following section:
Currently, the only option to move a device between workspaces is to set a Pincode on your device and claim it into a different workspace by entering this code on the "Add Device" dialog.
We have written up more information and a tutorial on how to do that here:
If you place a device in multiple workspaces, then the workspace that originally created the device is also the ultimate owner of that device.
If you want to transfer the ownership to another workspace, then this is currently only possible by removing the device and adding it into the desired workspace.
