Managing Asset Trees


This section describes the operations for managing the asset tree.

Prerequisite

  • Ensure that you have obtained the Developer role to have the access to Application Portal > Developer Console. If not, contact your OU administrator.

  • Ensure that you have read the limitations for asset trees. See Limitations.

Exporting Asset Trees

  1. In EnOS Application Portal > Developer Console, select Asset Trees, and click the Export icon on the top right.

  2. You can either export all of the asset trees listed by clicking Select All > OK, or export specific asset trees by selecting the asset trees you wish to export and click OK.

  3. Save the ZIP file to your local directory. The ZIP file will contain Excel files. Each Excel file represents an asset tree with the file name containing the asset tree’s tree ID.

Importing Asset Trees

This function enables you to batch create new asset trees or batch update existing asset trees using Excel. Batch importing of existing asset trees will update the existing information. If there are no existing asset trees, new asset trees will be created.

  1. In EnOS Application Portal > Developer Console, go to Asset Trees.

  2. Go to the + icon and click Batch Import Asset Trees.

  3. A pop-up window will appear. Upload a ZIP File that contains one or multiple .xlsx files. For file size and asset tree limitations, refer to the pop-up window.


    If you require a template, either click Download Blank Template or select one or multiple existing asset trees from Template and click Generate Template to generate Excel templates based on the selected asset trees. The templates will be inside a ZIP file. Edit the template once it’s downloaded, ZIP it up, and upload the file.


Excel Template Parameters - Asset Tree Worksheet

Name

Mandatory/Optional

Description

Asset Tree ID

Mandatory

  • For creating new asset trees, enter an ID for the asset tree. 8-64 characters. Supports English alphabets and numbers. No spacing allowed.

  • For updating asset trees, the Asset Tree ID must match the asset tree’s asset tree ID that you are updating. If it cannot be found, a new asset tree will be created.

Asset Tree Name (Default)

Mandatory

The default name for the asset tree which will be used when asset tree names in other languages are not given. 1 - 64 characters. Does not support <>;@*%&\ characters.

Asset Tree Name (Internationalization)

Optional

The internationalization name of the asset tree, e.g. English(en_US) and Simplified Chinese(zh_CN). If not given, the default asset tree name will be used. 1 - 64 characters.

Root Asset ID

Mandatory

  • For creating new asset trees, enter the asset ID of an existing device/logical asset to bind it to the asset tree as the root node. If the asset ID cannot be found, it will be an invalid record.

  • For updating asset trees, the Root Asset ID must match the root asset ID of the asset tree that you are updating. If it cannot be found, it will be an invalid record.

Tags

Optional

The asset tree tags in the form of key-value pairs. The format is in JSON and both key and value must be String. A maximum of 100 tags is supported for one asset tree. Example: {“key”:”value”}


You can specify the parent-child relation in the asset tree using the Node Association worksheet.

Excel Template Parameters - Node Association Worksheet

Name

Mandatory/Optional

Description

Parent Asset ID

Mandatory

The asset ID of the parent node.

Asset ID

Mandatory

The asset ID of the child node.


Note

  • Do not leave blank rows between the rows as the file may fail to import.

  • Each Excel file represents 1 asset tree. Therefore, only the first row of data in the Asset Tree worksheet will be used; all subsequent rows will be ignored.


../../_images/asset_tree_batch_import.png


4. Click Import.

5. If invalid records exist, a pop-up window will show an error message and a Download Error File link. Click to download the file, check the cause of the error, rectify it, and upload the file again.

6. Once the asset trees are successfully imported, the new asset trees will appear in Asset Trees.

Editing Asset Information

To edit the asset information such as its name, timezone, tags, and etc., click the Edit button edit next to the corresponding section.

You can edit an asset tree with other users simultaneously from 2.4 CU3.

Deleting a Node

Click the - next to a node to delete it. If this asset has sub-nodes, you must select Remove all the sub-nodes under this asset to delete it.


../../_images/deleting_asset.png

Note

By deleting a node, you only delete its association to the asset tree, and not the asset in Device Management > Device Assets or Device Management > Logical Assets.

Deleting an Asset

Go to Device Management > Device Assets or Device Management > Logical Assets in EnOS Application Portal > Developer Console. Search for the device or logical asset and delete it accordingly.

Note

If you delete an asset before deleting the corresponding node on the asset tree, the node becomes invalid and you cannot attach any sub-nodes to it.

Deleting an Asset Tree

  1. Go to the asset tree that you wish to delete.

  2. Make sure no sub-nodes exist under the asset tree. Delete them if they exist.

  3. Go to the Asset Tree Details page, scroll to the bottom, and click the Delete button.


../../_images/deleting_asset_tree.png

Moving a Node

You can move any node on an asset tree except the root node. Click and drag node to move it. If your destination is deeper than Layer 7 of a tree (the root node being layer 1), the move operation will fail. By moving a node, all assets bound to it as sub-nodes will also be moved to the new location.