Versions Compared

Old Version 25

changes.mady.by.user admin

Saved on

compared with

New Version Current

changes.mady.by.user Paulo Tsuchiya

Saved on

Key

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

Overview

This page presents information on how to work with the Asset Tree. It will also show one of ways one can create some custom graphics objects, like DataGrid Tables and Text Output, which will map automatically to the selected asset in the tree.

For an a more advanced example on how the Asset Tree can be used in solutions, go to Self-Aware Asset Displays.

Info

Watch the video tutorial here.

The Asset Tree is a graphical tool on the software platform for organizing 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.

On this page:

Table of Contents
maxLevel3

Image Removed

stylenone

Tip
titleSolution Example

Custom

Configuring the

Asset Tree

Configuration Workflow

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

The Asset Tree has pre-defined folders:

  • BaseTags: All local tags created in the solutions that were not placed in any folders (levels) are automatically placed in this folder.
  • ExternalTags: 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,

    Example


    Key Concepts and Terms

    Asset Tree

    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 or a final branch.

    Asset Folder

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

    RootTags Folder

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

    Linked Folder 

    A folder dynamically linked to data from a TagProvider Connection.

    Understanding the Asset Tree

    The Asset Tree is the main centralized location for configuring your Unified Namespace, tags, and assets organization. In this interface, you can create AssetFolders, new tags, move elements within the tree, and create TagProvider Connections.

    When the solution is running and the Designer is connected to the runtime, the Asset Tree also displays the current values for the tree elements.

    Asset Tree User Interface

    • Left Side: Shows the Asset Tree with a toolbar for localized actions.
    • Right Side: Displays detailed information about the selected Node and its children.


    Asset Tree Toolbar

    Image Added

    Typical Actions:

    • Create a New Folder: Organize and group assets by clicking the new Asset Folder icon or right-clicking the Asset Tree.
    • Create New Tags: Select a folder, then use the New Tag toolbar button or right-click menu
    ,
    • to create a new tag
    inside
    • within that folder.
    • Move Tags to
    selected folders: Just drag
    • Selected Folders: Drag tags from the
    BaseTags
    • RootTags folder
    —
    • or other
    location —
    • locations to the desired
    placement level at
    • position in the tree.
    Insert
    • Link Remote
    assets
    • Data: If
    there is a ExternalTags connection
    • an TagProvider connection is defined,
    you can
    • insert specific
    assets
    • data from the external system
    in
    • into the
    asset tree.

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

    Image Removed

    By right-clicking
    • Asset Tree.
    • Rename Folders or Tags: Right-click any folder or tag
    , you can also
    • to rename it directly from the Asset Tree.
    You can copy/paste
    • Copy/Paste Folders or Assets: Copy an entire folder or just one
    Asset from one folder
    • asset to another
    . By doing so, all Tags (and their Alarms, Historian, and Device the same name Tag
    • folder. All tags (including alarms, historian, and device configurations) will be copied as well.
    You can also have
    • Duplicate Tag Names: The same tag name can be used in more than one folder.
     
    • Monitor Tag Values: Once
    your
    • the solution is running,
    you will be able to monitor the Tag
    • monitor tag values directly from the Asset Tree through the Value column.

    Configuring the Asset Tree

    Configuration Workflow

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

    The Asset Tree has a pre-defined folder called "RootTags," which contains all local tags not placed in any 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 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.

    Image Removed

    You can add Dynamic Data from the ExternalTags inside your treeview structure. For more information, please refer to the External TagProviders 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

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

    Working with the Asset Tree

    Show the Asset Tree on displays

    Once your Asset Tree is defined, you'll be able to see it in the Draw Environment, on the right-side of the screen, where you can drag them into any display.

    Image Removed

    Add the component to your display, and customize it according to the settings described below. Does this still exist in v10?

    Assets settingsImage Removed

    The parameters are described as follows:

    AssetsControl ConfigurationControlNameElement's reference name so its properties can be accessed and manipulated in CodeBehind.SelectedAssetTag that will be receiving the selected Asset Name in Runtime as a String.Selected Path-------------------Initial Path-------------------Branch Filter-------------------Attribute Filter-------------------BlindingSelect OneWay or TwoWay or OneWay to Source.SelectedLevel

    Tag that will be receiving the selected Level Name in Runtime as a String.

    Show Only TagsFlag that indicates if the Asset Tree will display only Tags or other project objects (such as Displays).Show 'Root Tags' On RootBy default, all common type Tags (Integer, Digital, Text, etc) are added to the Root. By unchecking this option you can filter these elements out.Expand TagsFlag that indicates if multi-level Tags can be expanded (Templates, Arrays). If unchecked, only the main Tag will be in the Asset Tree.Show Client TagsFlag to define if client domain Tags will be displayed in Runtime. If unchecked, only server domain Tags will show up.Show 'LinkedTags Sources' on root-------------------Prefer Display TextFlag to indicate if the text that will show up in the Tree is the TagName or its Alias (defined in Unified Namespace > Asset Tree > DisplayText). If checked and the column is empty, the TagName will be used.LocalizableIf checked, Tag Names (or aliases) can be translated to different languages according to your project dictionary's settings.

    At Displays / Draw, under the Modules components, you can find the AssetTree Control. Simply drop this control onto your display, and the Asset Tree will be available in Runtime Displays for operators.

    → Go to AssetTree Control for more information.

    Accessing Variables on the AssetTree

    Tag Syntax

    Access a tag directly using its full name, including folders.

    Example: Tag.Area1/linha1/state

    Asset Path Syntax

    Use the Asset keyword to dynamically show the selected tag’s path.

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

    Useful for dynamic mapping or accessing values from TagProviders.

    Example: Asset(client.Context.AssetPath + "State1")

    In this example, the expression combines the selected folder with “State1” to display the corresponding State1 element from the Asset Tree

    CodeBehind and IO Components

    You can also access the Asset elements from the CodeBehind by navigating through the TagNamespace. IntelliSense will display the Tags and their respective Levels.

    CodeBehing tabImage Removed

    Similar to the ExternalTags approach, the elements from the Asset View can be accessed with the syntax: ASSET(”? CompleteAssetName ?”) either in a TextBox element or the CodeBehind.

    Image Removed

    Runtime Behavior

    In runtime, your Asset Tree and its components will look like the image below.

    Image Removed

    The IO element mapped with the ASSET(” CompleteAssetName ”) syntaxwill be resolved similar to the TK.GetObjectValue and will display the current value of the specific Tag it was mapped to.The SelectedAsset and SelectedLevel Tags will also change according to the element you click on.

    In this section:

    Page Tree
    root@parent
    spacesV10