Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

he The Asset Tree is a graphical tool on the software platform for organizing  solution solution data within a customizable hierarchy. It enhances navigation, data management, and visualization of complex industrial systems. Users can create folders, add tags, and associate metadata (e.g., alarms, historians). During runtime, the AssetTree Control displays the hierarchy, allowing interaction with elements and viewing of relevant data. The ASSET() syntax allows programmatic access to asset elements for integration with other system components and processes.

On this page:

Table of Contents
maxLevel3
stylenone

Tip
titleSolution Example

Custom Asset Tree Example



Key Concepts and Terms

Asset Tree

Hierarchical A hierarchical representation of the solution’s real-time data variables, composed of tags and nodes.

Element 

Any item in the Tree, whatever is a Node node or a final branch.

Asset Folder

Nodes in the tree that are containers for other objects or partial paths for TagNames.

BaseTags

RootTags Folder

Pre-defined node holding all tags not in any Asset Folder, helping manage large solutions.

Linked Folder 

Dynamically A folder dynamically linked to data from a TagProvider Connection.


Understanding the Asset Tree

The Asset Tree is the main centralized location for the Configuration of configuring your Unified Namespace, Tags and Assets Organization. At tags, and assets organization. In this interface, you can create AssetFolders, new Tagstags, move elements on within the Treetree, and create connections with external TagProvider Connections.

When the Solution solution is running , and the Designer is connected with to the Runtimeruntime, the Asset Tree also shows displays the current Values values for the Tree tree elements. 

Asset Tree User Interface

The left side shows the AssetTree with its own
  • Left Side: Shows the Asset Tree with a toolbar for localized actions.
 The right side shows
  • Right Side: Displays detailed information about the selected Node and
the children's of the selected element. 
  • its children.


Asset Tree Toolbar

Image AddedImage Removed

Typical Actions:

  • Create a new folder: Folders allow you to organize, group, and create hierarchies for your assets. Click New Folder: Organize and group assets by clicking the new Asset Folder icon to create one or right-click clicking the Asset Tree.
  • Create new tags: After selecting New Tags: Select a folder, then use the New Tag toolbar button or the right-click menu to create a new tag inside within that folder.
  • Move tags Tags to selected foldersSelected Folders: Drag tags from the BaseTags RootTags folder or other locations to the desired placement level position in the tree.
  • Insert remote assetsLink Remote Data: If an ExternalTags TagProvider connection is defined, you can insert specific assets data from the external system into the Asset Tree.
  • Rename Folders or Tags: Right-click any folder or tag to rename it directly from the Asset Tree.
  • Copy/Paste Folders or Assets: Copy an entire folder or just one asset to another folder. All tags (including alarms, historian, and device configurations) will be copied as well.
  • Duplicate Tag Names: The same tag name can be used in more than one folder.
  • Monitor Tag Values: Once the solution is running, monitor tag values directly from the Asset Tree through the Value column asset tree.

Configuring the Asset Tree

Configuration Workflow

The Asset Tree configuration is located at Unified Namespace / Asset Tree.

The Asset Tree has a pre-defined folders:

BaseTags: All local tags created in the solutions that were

folder called "RootTags," which contains all local tags not placed in any

folders (levels) are automatically placed in this folder.
  • TagProviders: When creating ExternalTags connections, they are automatically included in this folder, so you can easily browse the dynamic contents of the remote system. 

  • The typical action when configuration the asset tree are:

  • Create a new folder: Folders allow you to organize, group and create hierarchies for your assets. Click the new Asset Folder icon to create one or right click the Asset Tree.

  • Create new Tags: After selecting a folder, use the New Tag toolbar button or right-click menu, to create a new tag inside that folder.

  • Move Tags to selected folders: Just drag tags from the BaseTags folder — or other location — to the desired placement level at the tree.

  • Insert Remote assets: If there is a ExternalTags connection defined, you can insert specific assets from the external system in the asset tree

    other folders. For system integrity reasons, it is not possible to create new asset folders inside the RootTags folder; this is the only exception in the software.

    The image below describes an example of a solution's hierarchy.

    Image Removed

    By right-clicking any folder or tag, you can also rename it directly from the Asset Tree. You can copy/paste an entire folder or just one Asset from one folder to another. By doing so, all Tags (and their Alarms, Historian, and Device configurations) will be copied as well.

    You can also have the same name Tag in more than one folder. 

    Once your solution is running, you will be able to monitor the Tag values directly from the Asset Tree through the Value column.

    Image Removed

    You can add Dynamic Data from the ExternalTags inside your treeview structure. For more information, please refer to the UNSTagProviders Connections documentation.

    To create tags and folders in the Unified Namespace, follow these simple steps:

    • Go to Unified Namespace → Asset Tree.

    Image Removed

    • Add New Asset Folders

    Image Removed

    • Add New Tags

    Image Removed

    Image Added


    Adding New Asset Folders

    1. Click the "Add Asset Folder" icon on the toolbar of the Asset Tree
    2. Right-click on the RootTags folder on the Asset Tree.
    3. Right-click on a created Asset folder on the Asset Tree.

    Adding New Tags

    1. Click the "New Tag" icon on the toolbar of the Asset Tree
    2. Right-click on the RootTags folder on the Asset Tree.
    3. Right-click on a created Asset folder on the Asset Tree.
    4. Use the "New Tag" button in the main toolbar.

    If you don't specify a folder, the new tag will be placed in the 'Base TagsRootTags' section of the tree.


    Working with the AssetTreeAsset Tree

    Show the AssetTree Asset Tree on displays

    At Displays / Draw, under the Modules components,  the is a TAssetTree controls.Just drop that control to your Display, and the AssetTree is now you can find the AssetTree Control. Simply drop this control onto your display, and the Asset Tree will be available in Runtime Displays for the Operatorsoperators. 

    Go to TAssetTree AssetTree Control  for information 

    Map Tags and Assets on CodeBehind and Displays objects

    When creating Scripts, or mapping Tags for graphical elements, the AssetTree will be available on the ObjectSelection window.

    There are two ways to access the variables on the AssetTree. 

    for more information.

    Accessing Variables on the AssetTree

    Tag Syntax

    If you need to access a Tag in the AssetTree you can get directly the TagName, even that tag name has folders in the name. Access a tag directly using its full name, including folders.

    Example:   Tag.Area1/linha1/state

    Asset Path Syntax

    Another way to reach the same value is using the ASSET keywordUse the Asset keyword to dynamically show the selected tag’s path.

    Example:   Asset("/Area1/linha1/stateState1")

    The Asset Path syntax is useful when using Useful for dynamic mapping , or using TagProviders, which values are not in Tags. accessing values from TagProviders.

    Example:  Asset Asset(client.SelectedAssetFolder Context.AssetPath + "/stateState1")

    in In this example, the expression will get the SelecteFolder combine with the string "/state", and that is the element from the AssetTree that will be show. combines the selected folder with “State1” to display the corresponding State1 element from the Asset Tree.


    In this section:

    Page Tree
    root@parent
    spacesV10