A tag is an annotation of artifacts for filtering. It is a custom value given to a group of Things
By using tags you will be able to easily filter certain Things
tags: sampletag AND msisdn: 531*. For more information on using search, see Using Search
Tags are useful when you want to aggregate a group of Things
It is possible to use Thing tags in Cloud Triggers to define which group of devices will trigger an action to occur.
In the above diagram:
- Search query tags:tag1 will return Device 1, Device 1.1, Device 1.2, Device 3, Device 3.1, and Device 3.2
- Search query tags:tag2 will return Device 2, Device 2.1, Device 2.2, Device 3, Device 3.1, and Device 3.2
- Search query tags:tag1 OR tag2 will return All the Devices
- Search query tags:tag1 AND tag2 will return Device 3, Device 3.1, and Device 3.2
You will be able to add a tag while creating/editing a Thing
Tags appear above the list of Things, Users, and Files and is used for filtering these artifacts by selecting tag(s). It includes both user defined and system defined tags.
Tags are visual depiction of user-generated and system-generated tags attached to IoT Portal content, using color and font size to represent the prominence or frequency of the tags depicted.
||Add a tag to a file. For more information on adding a tag to a file, see Uploading a file|
||Add a tag to a file within a Thing's view. For more information on adding a tag to a file within a Thing's view, see Files|
||Denotes the tags to automatically add to a new Thing when it is added through auto-registeration. For more information on creating an application, see Creating an Application
||Adding or deleting tags using cloud actions. For more information on adding or deleting tags using cloud actions, see thing.tag.add action and thing.tag.delete action|
||Add/edit tags while adding or editing a Thing. For more information on adding or editing a Thing, see Creating Generic thing or Creating LWM2M thing or Creating a Telit module|
||Add tags while editing a connection. For more information on adding tags to a connection, see Editing a Connection|
||Add tags while creating or editing dashboards. For more information on adding tags while creating dashboards, see Creating a Dashboard|
When a Tag is added to a Thing, in the Tag field, you will see the tag listed in the filters across the top of the Things list. Additional tags of disconnected, connected, and geofence (if a device is within a geofence) will appear if devices are in those states. Tags are often used to filter by customer or site. As shown below, there are tags associated with different Things. By clicking the thingsee tag the list of devices is reduced to those with that tag.
There are multiple ways to add tags and security tags to a device or multiple devices at once. Explained previously in this section they are added automatically when using the auto-registration feature of an application but they can also be added manually.
If you are adding tags to one Thing, you simply click the Edit button to the left of the Thing on the Things list. If adding tags to multiple Things at once, you select the Things by checking the Things you want to tag, then click Actions at the top right, then Change Tags.
Reserved tags are specific tags (e.g. gateway) that are reserved and cannot be manually set by a customer as they will get the error such as. "Editing thing failed. Error: Reserved tag 'gateway' is not allowed. Please, try again".
The reserved tags are the following: