Use smart names for tags
- Last UpdatedFeb 19, 2025
- 1 minute read
Tag labels represent many different pieces of information, such as tag names, location, units, keywords, etc. This can make it difficult to differentiate fully-qualified tag names when multiple tags share some common values.
Smart Names can be used to make tag names more readable in your reports. Smart Names are generated for a group of fully-qualified tag names by applying the following rules:
-
For each tag, start with the Alias if one is defined, otherwise start with the TagName
-
Prefixes and suffixes are treated independently
-
Prefixes and suffixes break only on whitespace and punctuation: - , . _ / \ |
-
Prefixes and suffixes are case-insensitive
-
Common prefixes and suffixes are truncated from all labels
-
If removing common prefixes and suffixes results in an empty label, do not truncate
-
If removing common prefixes and suffixes results in any duplicate labels, do not truncate
-
The final format of the Smart Name is "Trimmed Label [Trimmed Location]".
Note: The location portion of the Smart Name is optional, depending on whether location information is both available, and different, for the selected tags
Example 1:
This example demonstrates tags with common prefixes and suffixes.
|
Labels before trimming |
Labels after trimming |
|
a.b.c.d.product.level.LA |
product |
|
a.b.c.d.water.level.LA |
water |
Example 2:
This example demonstrates tags with common prefixes and suffixes that would result in an empty label if truncated.
|
Labels before trimming |
Labels after trimming |
|
a.b.c.d |
a.b.c.d |
|
a.b.e.c.d |
a.b.e.c.d |
Example 3:
This example demonstrates tags with common suffixes, with available location information.
|
Labels before trimming |
Location before trimming |
Labels after trimming |
|
product.level.LA |
LA/Plant1 |
product |
|
water.level.LA |
LA/Plant1 |
water [Plant1] |
|
water.level.LA |
LA/Plant2 |
water [Plant2] |