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.
- How to group devices in projects
- How to add names and descriptions for devices
- How to filter and search for devices within projects
- How to search for devices across projects
- How to use labels to associate information with devices
- How to include sensors in dashboards for data visualization
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.
- Mark the devices to move
- Select Move Devices
- 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.
- Select MOVE to transfer the devices to the target project immediately
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.
- Select your device in the project overview
- In the detailed view:
- Sensor name: Write a descriptive name for the device
- Description: Write a description
- The name and description are updated automatically
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.
How to filter and search for devices within a project
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.
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 them to filter on various devices. |
Returns all devices in the project that matches the device ID. Example:
|
|
Device name Search for the device name manually set by users |
Type the device name. |
Returns all devices in the project where the text matches the name, label, or device type. Example: |
|
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: |
|
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 |
|
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 |
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.
- Select the project drop-down in the header
- Change the search type from Projects to Device ID
- 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.
- Select the device(s) you want to manage labels for
- Select Set labels
- In the pop-up:
- Key: Type the desired key
- Value (optional): Type the corresponding key-value
- Select (+) Add Label to add the label for the selected devices, OR select the
next to the label to have it removed.
- Save the changes by selecting Update Labels.
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.
- Mark the sensors you want to add to the dashboard
- Select Add to dashboard
Go to the Project dashboard to view and edit the newly created card.