Using Tags

A tag is an annotation of artifacts for filtering. It is a custom value given to a group of Things or Connections or files or users for easy filtering and is used as a filtering criteria on list pages such as the Things, Users, and Files page to reduce the list of artifacts displayed based on criteria (e.g. customer, department, or site).

By using tags you will be able to easily filter certain Things or Connections and keep the additional search criteria. For example: 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/Connections that satisfies certain conditions. For example: A factory with several stores and each stores contain certain number of devices. You can tag the devices in each store with the store #. Since the devices are tagged with the store # you will be able to run a query using the tag name to find a specific condition, like you can query to see which store generated the most alarms.

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 or Connection or user or file. It is used to filter a long list of Things, Users, or Files. Also used to perform actions on a filtered group of things like triggering an event in cloud triggers or viewing data from a filtered group of devices in Dashboards.

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.

Tags Description
File Tags
/developer/files (New file button) Add a tag to a file. For more information on adding a tag to a file, see Uploading a file
/things/view (Files tab > Add 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
Thing Tags  
/applications/add (Auto Registration Tags) 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
/applications/edit (Auto Registration Tags)
/triggers/add (Actions > Action equal to thing.tag.add/thing.tag.delete) (Tags)
/triggers/edit (Actions > Action equal to thing.tag.add/thing.tag.delete) (Tags)
/campaigns/add (Actions > Action equal to thing.tag.add/thing.tag.delete) (Tags)
/campaigns/edit (Actions > Action equal to thing.tag.add/thing.tag.delete) (Tags)
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
/things/add (Tags)
/things/edit (Tags)
/things/change_tags (Tags)
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
/connections/edit (Tags) Add tags while editing a connection. For more information on adding tags to a connection, see Editing a Connection
/dashboards/edit (Tags)
/dashboards/edit (Tags)
Add tags while creating or editing dashboards. For more information on adding tags while creating dashboards, see Creating a Dashboard

Related Topics Link IconRelated Topics