Thing Console
The thing console is a tool for managing things registered in your application.
You can check the existing things and register new things. You can also manage states, commands, and triggers of things.
Launching thing console
Follow the steps below to launch the thing console.
- Select the application on the developer portal.
- Click on the "Things" icon.
- Select the "Thing-IF".
The old version of the thing console (deprecated) will launch if you click the "Console".
This will bring up a list of all things registered in your application.
Here, you can make the following operations.
- Click the "Onboard" button to onboard a thing.
- Click a thing in the list to make the following operations.
- Use checkboxes to make the following bulk operations.
- Click the "Enable/Disable" button after selecting the target things to enable/disable them.
- Click the "Delete" button after selecting the target things to delete them.
Filtering things
You can filter things in the list by specifying conditional expressions in the search window.
Clicking the "help?" button at the right of the search window will show you examples of conditional expressions.
As shown in these examples, a conditional expression is composed of a field and a condition applied to the field.
You can also concatenate multiple conditional expressions with AND/OR.
Available fields
You can specify the following fields. For the details of each field, see Register a thing.
- thingID
- vendorThingID
- thingType
- _vendor
- _firmwareVersion
- _productName
- _lot
- _created
- _stringField1 to _stringField5
- _numberField1 to _numberField5
You can also specify the following fields that represent the status of the thing.
- enabled: This field represents the thing status. The field value is true if the thing is enabled. The value is false if the thing is disabled.
- layoutPosition: This field represents the thing's category. If you are not using the gateway feature, the field value is "STANDALONE". If you are using the gateway feature, the field value is either "GATEWAY" or "ENDNODE" depending on the thing's category. See What is Gateway? for the details of the gateway and end node.
Available conditions
You can specify the following conditions.
Condition | Description | Examples |
---|---|---|
= | The field value is equal to the specified value | _vendor = "Kii" |
!= | The field value is not equal to the specified value | vendorThingID != "prototype_1" |
IN | The field value matches with one of the specified values | _firmwareVersion IN ("v1" "v2" "v3") |
^= or PREFIX | The field value starts with the specified value | _lot ^= "AAA" or _lot PREFIX "AAA" |
< | The field value is smaller than the specified value | _created < "2016-01-01T00:00:00+00:00" |
<= | The field value is smaller than or equal to the specified value | _productName <= "X" |
> | The field value is bigger than the specified value | _numberField1 > 3 |
>= | The field value is bigger than or equal to the specified value | _lot >= "AAA00" |
Field values
You can set field values as follows.
Type of the field value | Examples | Description |
---|---|---|
String | "abc" , "123" |
|
Integer | 123 |
Usable only for the field _numberField1 to _numberFields5 |
Date and time | 2017-01-01 , 2017-01-01T00:00:00+0900 |
Usable only for the field _created. Use ISO 8601 format. |
Boolean | true , false |
Usable only for the field enabled |
Null | null |
Concatenate and negate conditional expressions
You can apply the following logical operators to conditional expressions.
Condition | Description | Examples |
---|---|---|
AND or & | Concatenate conditional expressions with a logical AND | enabled = true AND layoutPosition IN ("ENDNODE" "GATEWAY") |
OR or | | Concatenate conditional expressions with a logical OR | enabled = false OR _firmwareVersion= "0.1" |
NOT or ! | Negate a conditional expression with NOT | NOT (enabled = false OR _firmwareVersion= "0.1") |