Datacake Docs
  • Welcome
  • Get Started
  • Changelog
  • Best practices
    • Best practices: Getting started
    • Best practices: Resolution (Timeframe)
    • Best practices: Dashboards
    • Best practices: Reports
    • Best practices: Grouping Devices
  • Datacake LNS
    • Getting Started
    • Gateways
      • Milesight LoRaWAN Gateway - UG6x
      • RAKwireless WisGate Edge Light 2
    • Devices
    • Add Devices without Gateway
  • Device
    • Product
    • Configuration
    • Claiming
    • Historical Data
    • Database
      • Configuration Fields
      • Fields
        • Manual input
        • Field Roles
        • Formulas
        • Mapping Fields
      • Data retention & Datapoints
      • Examples
        • Mapping 4-20mA Signals
        • Converting Units
  • Dashboards
    • Global Dashboards
      • Setting Homepage
    • Device Dashboards
    • Multi-Device Dashboards
    • Widgets
      • Value Widget
      • Chart Widget
      • Image Map
      • Map Widget
      • Text Widget
      • SOS Widget
      • Boolean Widget
      • iFrame Widget
      • Downlink Widget
      • Set Value Widget
      • Measurement List Widget
      • Heatmap Widget
      • Table Widget
      • Image Widget
  • Portal
    • Multi-Tenancy (Workspaces)
    • Reports
      • Energy Report
    • Administrators
    • Members
      • API Users
    • Security & Privacy
    • Billing
      • Support Packages
      • VAT Exemption / Tax ID
      • SMS Credits
      • Access Invoices
      • Unused time and Remaining time in Invoices (Prorations)
      • Codes
    • White Label
    • Rules
      • Legacy Rule Engine
        • Sending notifications via Telegram
      • New Rule Engine
        • Rule Engine Table Overview
        • Copy/Paste and Template Functionality
        • Advanced Rule Engine E-Mail and Webhook Templates
        • Time Restrictions
    • Zones
  • Cake Red
    • Get Started
    • Overview
  • LoRaWAN
    • Get Started
      • CSV Import
      • Custom LoRaWAN Device
    • Configuring LNS
      • The Things Stack (TTN / TTI) Automated Setup
      • The Things Stack (TTN / TTI) Manual Setup
      • Loriot
      • Kerlink Wanesy
      • Helium
      • ChirpStack
      • Tektelic
      • Actility ThingPark
      • Senet
      • Milesight Gateway
      • KPN
    • Downlinks (LoRaWAN)
      • Set Time Frame
    • Securing Webhooks
    • Payload Decoders
      • Location and GPS
      • Access Gateway Metadata
      • Access Measurements
      • Global Variables
    • Using Cayenne LPP
    • Converting Payload
  • Generic API Devices
    • HTTP Downlinks
  • Integrations
    • MQTT
    • Particle
      • Get Started
      • Adding Integrations
      • Decoding Payloads
      • Calling Functions
      • Templates
        • Particle Tracker One
    • Incoming Webhooks
    • Outgoing Webhooks
      • Securing Outgoing Webhooks in Datacake
    • Golioth
    • Blues Wireless Notecard
    • Sigfox
    • Swarm Asset Tracker
    • Grandcentrix Modbus Cloud Connect
    • YuDash LYNX IoT Gateway
    • Dragino NB-IoT
      • Changing NB-IoT Bands
    • Hardwario CHESTER
    • 1NCE OS
  • API
    • Exporting Data
    • Record Measurements via API
    • Node RED to Datacake
    • Generate Access Token
    • Internal MQTT
      • Get Started
      • MQTT Documentation
      • MQTT over WebSocket
      • Example Code
    • GraphQL API
      • Using GraphQL
      • Device Creation
      • Tutorials
        • Read Group via Tags
  • Guides
    • Python
    • Send Slack Notifications
    • Forward Data to Cake Red
    • Multiple Data Feeds
    • Automated Dynamic Downlinks
    • Ingesting JSON Data into Datacake API Devices
    • Working with Default HTTP Decoder on API Devices and Code Examples
    • Accessing Measurements in Decoders
    • Connecting Datacake to Notion Using Zapier
    • How to set up and use location on non-GPS devices
    • How to integrate with AWS IoT Core
    • How to Schedule Mass-Downlinks (Multicast) using Datacake Rule Engine
    • How to Map Sensor Values to Ranges or Booleans, Strings using Mapping Fields
    • Understanding Internal vs. External MQTT Brokers on Datacake
    • Sending UDP Messages between 1NCE OS and Datacake
    • Concepts of LoRaWAN Payload Decoders on Datacake
    • How to check if a value stays above or below limits for given time
Powered by GitBook
On this page
  • What are Workspaces?
  • What should I use workspaces for?
  • Your first workspace
  • Workspace Settings
  • Long SMS Mode and SMS Log
  • Switch between Workspaces
  • Device & Members Management
  • Create additional Workspaces
  • Invite People into your Workspace
  • Moving Devices between Workspaces
  • Ownership

Was this helpful?

  1. Portal

Multi-Tenancy (Workspaces)

Last updated 8 months ago

Was this helpful?

What are Workspaces?

Workspaces combine all elements and functions of the Datacake platform in one group.

  • Devices

  • Rules and Rule-Engine

  • Reports

  • Global Dashboards

  • Members

What should I use workspaces for?

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.

Your first workspace

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.

Workspace Settings

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.

Long SMS Mode and SMS Log

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.

Switch between Workspaces

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.

Device & Members Management

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.

Create additional 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.

Invite People into your Workspace

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:

Moving Devices between Workspaces

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:

Ownership

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.

Members
Claiming