Managing Logical Assets

Note

This feature is available for EnOS 2.1 update and newer releases.


The logical asset refers to a physical location or container that includes a series of devices that are of the same type or different types. For example, a wind farm is a logical asset, which includes several wind generators. Different wind farms will have common attributes, runtime data, and status, such as average wind speed, average power generation, etc.


In EnOS Management Console, you can create a logical asset at the Asset Trees page. To view, edit, or delete a logical asset, click Device Management > Logical Assets from the left navigation menu.

  • View: Click the View icon view of a logical asset to enter the Logical Asset Details page and view its asset information, attributes, measurement point, event, and asset-related files.
  • Edit: Click the Edit icon edit of a logical asset to modify its name, time zone, or description.
  • Delete: Click the Delete icon delete of a logical asset or use the batch delete function to delete two or more logical assets at one go.
  • View associated asset tree: Mouse over the Asset Tree icon view_asset_tree of a logical asset to view its associated asset tree(s) and click the name of the asset tree to go to its Asset Tree page.

Prerequisites

Ensure that you have read the limitations for logical assets. See Limitations.

Exporting Logical Assets

This function enables you to export logical assets across different models.

  1. In EnOS Management Console, select Device Management > Logical Assets, and click Batch Operations.
  2. You can either export all of the logical assets listed by clicking Export > Export All, or export specific logical assets by selecting the logical assets you wish to export and click Export > Export Selected.
  3. Save the ZIP file to your local directory. The ZIP file will contain Excel files. Each Excel file represents a model with the file name containing the model’s model ID, with the logical assets inside each Excel file under the model that the Excel template represents.

Importing Logical Assets

This function enables you to batch create new logical assets or batch update existing logical assets across different models using Excel. Batch importing of existing logical assets will update the existing information. If there are no existing logical assets, new logical assets will be created.

  1. In EnOS Management Console, select Device Management > Logical Assets.

  2. Click the Import button.

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


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

Note

Each Excel template represents a model. The naming convention is “ModelId_yourModelId.xlsx”, where yourModelId refers to the model ID of a model, which can be found in Models. Therefore, all logical assets inside the Excel file will be under the model that the Excel template represents.


Excel Template Parameters
Name Mandatory/Optional Description
Asset ID

Depends on creating new or updating logical assets.

See description for more information.
  • For creating new logical assets, leave this blank. The system will generate an asset ID when the logical asset is successfully created.
  • For updating logical assets, the Asset ID must match the logical asset’s asset ID that you are updating. If it cannot be found, it will be an invalid record.
Asset Name (Default) Mandatory The default name for the logical asset which will be used when logical asset names in other languages are not given. 1 - 64 characters. Does not support <>;@*%&\ characters.
Asset Name (Internationalization) Optional The internationalization name of the logical asset, e.g. English(en_US) and Simplified Chinese(zh_CN). If not given, the default logical asset name will be used. 1 - 64 characters.
Time Zone Mandatory The local time zone of city of the logical asset. If you need to use Daylight Saving Time (DST) for the logical asset, select the city where DST applies. EnOS will validate format of the time zone.
Description Optional The description of the logical asset. Max 512 characters.
Device Tag Optional The logical asset tags in the form of key-value pairs. The format is in JSON and both key and value must be String. Example: {“key”:”value”}


Note

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


../../_images/logical_asset_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 logical assets are successfully imported, the new logical assets will appear in the list of logical assets in Device Management > Logical Assets.


For more operations for logical assets, see Managing Asset Tree.