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.

  1. Select the application on the developer portal.
  2. Click on the "Things" icon.
  3. 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.

The "Trait" button is for our paid feature "trait"; the feature allows you to manage things more conveniently. Please contact support@kii.com if you want to know more about the "trait" feature.

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")