Tagging Points & Histories (SkySpark)
Point Tags
Tagging your points in your SkySpark project should be done in accordance to the Project Haystack standards listed in their tag documentation. The basic method involves using the Builder app in SkySpark to create the hierarchy as well as add or delete tags.
From the Builder app, a SkySpark administrator can create new sites, equips, points, or even import them from a connector. More details and tutorials for these apps can be found via the official SkySpark documentation (login required).
Minimum Requirements
The following are the minimum requirements for tagging points and histories. However, we recommend following the full haystack standard which allows more advanced querying (for example, querying for site meters).
| Points | Histories | |
|---|---|---|
| Tags | point kind | his kind |
| Relations | siteRef | siteRef |
Tagging with Axon
To add tags in a batch method, a user can utilize SkySpark's Axon scripting language in the Folio app or in a custom function. This is an advanced topic so it's recommended to not attempt this method unless familiar with the Axon scripting language.
For instance, if you had a bunch of meter equips already tagged and you wanted to additionally specify that these were electrical meters by adding an elec tag it would be as easy as invoking the following in Folio:
readAll(meter).each(r => r.diff({ elec, batch }).commit)
Remember to always back up your database before performing batch edits. It's also good practice to add an additional tag (like batch in the above example) so that you can quickly re-query just that tag that isn't used anywhere else so you can easily reverse the operation if needed.
More information on Axon can be found in the official SkySpark documentation (login required).
Point Tagging Standards
Below are links to Project Haystack tagging standards for common point types to help ensure you are using the correct tags on your points:
In addition to point tagging, "equip" tagging is also extremely useful and necessary for creating proper references between the points and their respective equipment. Click here for more information on tagging equipment.
Using the "disMacro" tag
Do you have a lot of energy trends all with the same name like "kWh"? Try batch-adding the "disMacro" tag to your points.
disMacro uses $ to define template parts, so if you wanted your point to display the equipment name followed by the point name, you'd set your disMacro (String) tag as: "$equipRef $navName"