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
  • Basics
  • Setting Field Role
  • Existing Field
  • New Field
  • Using Field Roles
  • Device List
  • Device Gallery
  • Available Roles
  • Primary
  • Secondary
  • Device Battery
  • Device Signal
  • Device Location

Was this helpful?

  1. Device
  2. Database
  3. Fields

Field Roles

Last updated 2 years ago

Was this helpful?

Basics

The Field Role function allows you to assign a role or function to individual database fields. The following roles are available:

  • Primary

  • Secondary

  • Device Battery

  • Device Signal

  • Device Location

These roles are then used by widgets or lists to automatically display certain information from your sensors.

For example, in the device list, you now have the option of displaying the favorite values of a sensor directly in the table or using the new grid view to display each device as a map with all information.

Setting Field Role

Existing Field

Navigate into the database section of your Datacake device.

Now click on the dots button at the right end of a field row. This will open up a context menu where you have to click on "Edit Field".

When you click on "Edit Field" this will open up a configuration modal where you can also set the Field Role. Click on "Role", this will open up a context menu that shows all the available field roles. Simply select one and don't forget to press on "Update Field".

New Field

If you are creating a new database field, you have the option to directly set the field role.

Using Field Roles

Device List

Field roles can be used to display measured values of your sensor devices directly in the device list table.

All you need to do is activate which field roles you want to display on the field list. Click on "Columns" and simply select the field roles.

Device Gallery

You can switch your device list from a table view to a grid layout that shows you all devices as cards in a gallery overview.

Available Roles

Primary

Define the most important database field or the most important measured value of a sensor as Primary.

Secondary

Consequently, define the second most important sensor value as Secondary.

Device Battery

With the Device Battery role, Datacake uses the selected field as battery information. It does not matter if you enter a numeric value as voltage or percentage.

Device Signal

With this role, Datacake uses the marked field as information about the signal strength of a sensor, e.g. RSSI or any other value.

Device Location

A Device Location can only be applied to Geolocation fields and tells Datacake that this field contains information about the location of the sensor.

Datacake Device List Field Roles
Datacake Device Gallery View