Managing devices in Studio

This article shows how to manage your sensors and Cloud Connectors using Studio. You can also use the API to name, label, and move sensors between projects. 

What you need

  • Permission: A user role of Project Developer or higher to edit device properties
  • Permission: A user role of Project Administrator or higher to move devices between projects
  • Permission: A user role of Organization Administrator to move devices between organizations 

Content

To manage your devices, log into Studio, select the project with your devices from the top menu, and select Sensors & Cloud Connectors.

Where can I find my recently purchased DT sensors?

Recently purchased DT sensors need to be claimed by the Studio organization. The newly claimed devices are placed in your organization's Inventory project

How to group devices in projects

We recommend organizing your devices into projects to group devices that naturally belong together and simplify access management. For example, group your devices for different sites, customers, activities, and similar. Once you have created the new projects, you can move the sensors and Cloud Connectors into the project they should belong to by following these steps.

  1. Mark the devices to move
  2. Select Move Devices
  3. You will now be asked to fill in the following:
    • Select organization (if you have access to multiple): Select the destination organization in the drop-down list
    • Select project: Start typing the target project name and select it. If you can not select the project, check that you got permission to make changes
  4. Select MOVE to transfer the devices to the target project immediately

mceclip0.png

Moving devices between organizations

By transferring devices to a new organization, you also move the subscription billing responsibility to the new organization.

How to add names and descriptions for devices

To quickly identify your devices after an installation, we recommend giving the sensors or Cloud Connectors suitable names and descriptions.

  1. Select your device in the project overview
  2. In the detailed view:
    • Sensor name: Write a descriptive name for the device
    • Description: Write a description
  3. The name and description is updated automatically

2021-09-08_13-32-40.png

If you go to the project overview, you will see the updated sensor name in the list of devices.

Manage your devices in the detailed view

You can move a device to another project and manage its labels in the detailed view by selecting the device.

You can use the search bar in the Project view for free text searches or filtration.

Filters

Click the arrow in the search bar to view our predefined filters. Choose to filter the device overview by device type, kit, or device label. 

mceclip2.png

 

Using the search bar

This table shows you how to use the search bar to find or filter devices based on different metadata. Please also see How to identify a device. Free-text searches will generally search across device IDs, names, device types, labels, or keys, which sometimes can lead to unexpected results. 

Example: You want to search for all water sensors in your project, so you type "water" in the search field. This returns all your water sensors, but if you, for instance, have a temperature sensor on a water pipe, which you have given the name "Water Pipe Sensor" or a label including the word "water," these sensors will be included in the result.

Find device by How to search Expected result

Device ID

Search for the globally unique device ID that consists of 20 letters and numbers. 

Type the complete device ID using the keyboard or a QR-scanner.

Tip! Type multiple IDs with a space between to filter on various devices.
Add * to the end of your query to search for partial matches.

Returns all devices in the project that matches the device ID.   

Example:

 

Skjermbilde_2021_12_20_kl._15.22.51.png

 

Device name

Search for the device name manually set by users

Type the device name.

Tip! Add * to the end of your query to search for partial matches.

Returns all devices in the project where the text matches the name, label, or device type.

Example: 

mceclip1.png

Device Type

Search for the various device types. Please see an overview of the different device types here

Type [type:] and the device type 

Returns all devices of the type in the project

Example:

Skjermbilde_2021_12_20_kl._15.16.42.png

Device label or key

Search for devices with a specific predefined or self-defined Device label key or key/value combination.

Type [label:] or [label:key=] and the key/value

Returns all devices in the project with the label or key

Example:Skjermbilde_2021_12_20_kl._15.31.10.png

Kit label

All our shipping boxes have a unique kit label printed on the side. Use the Kit label to search for all devices within a kit. 

Type [label:kit=] and the kit label. 

Returns all devices in the project with the kit label

Example:Skjermbilde_2021_12_20_kl._15.36.13.png

How to search for devices across projects

If the complete device ID of your device is known, you can search for the device across all the projects in Studio. All our Cloud Connectors have the device ID printed on the back. Today our sensors have a QR-code printed on the front, and the ID will appear by scanning the code. Earlier sensors variants came with the complete ID printed on the front. 

  1. Select the project drop-down in the header
  2. Change the search type from Projects to Device ID
  3. Enter the complete 20 character device ID

If you have access to the project, you will now be redirected to the device overview. 

How to use labels to associate information with devices 

Use labels to associate relevant information with your sensors and Cloud Connectors. Labels are searchable and have a key or a key/value combination. The key is required and unique, while the value is optional and can provide additional information. 

  1. Select the device(s) you want to manage labels for
  2. Select Set labels
  3. In the pop-up:
    1. Key: Type the desired key
    2. Value (optional): Type the corresponding key-value
  4. Select (+) Add Label to add the label for the selected devices, OR select the 2021-09-10_15-30-40.png next to the label to have it removed.
  5. Save the changes by selecting Update Labels. 

2021-09-08_13-45-38.png

 

Examples of use

    • Label sensor with external ID for simple ID-mapping
    • Setting location code on the sensor to be able to look up all sensors in a given area
    • Workflow states, such as not_installed, etc
    • Include the label information in the events forwarded through DataConnectors for processing on your platform

How to include sensors in dashboards for data visualization 

You can add one or more sensors to the Project dashboard easily.

  1. Mark the sensors you want to add to the dashboard
  2. Select Add to dashboard

Go to the Project dashboard to view and edit the newly created card.

2021-09-08_14-04-22.png