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 deviceWISE Cloud 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

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:

  • gateway
  • connected
  • disconnected
  • geofence

 

Related Topics Link IconRelated Topics